List Suppliers

mapping.travel connects your hotel inventory to a curated set of supplier datasets. These endpoints let you discover which suppliers the platform supports, see which ones your organization has connected, and track any supplier requests you have submitted.

GET /api/v1/suppliers

List all active suppliers available on the platform. This endpoint does not require authentication.

GET https://api.mapping.travel/api/v1/suppliers

Response

object[]

required

Array of active supplier objects.

Show supplier properties

string

Unique UUID of the supplier.

string

Short identifier code for the supplier (e.g. expedia, booking).

string

Display name of the supplier.

string

Short description of the supplier.

string

URL of the supplier logo image, if available.

boolean

Whether the supplier is currently active on the platform.

number

required

Total number of active suppliers returned.

Example

curl https://api.mapping.travel/api/v1/suppliers

{
  "suppliers": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "code": "expedia",
      "name": "Expedia",
      "description": "Global online travel marketplace",
      "logoUrl": "https://cdn.mapping.travel/logos/expedia.png",
      "isActive": true
    },
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000002",
      "code": "booking",
      "name": "Booking.com",
      "description": "Online accommodation platform",
      "logoUrl": "https://cdn.mapping.travel/logos/booking.png",
      "isActive": true
    }
  ],
  "total": 2
}

GET /api/v1/suppliers/my-suppliers

List the suppliers connected to your organization.

GET https://api.mapping.travel/api/v1/suppliers/my-suppliers

Authentication is required. Include your API key in the X-API-Key header.

Response

object[]

required

Array of supplier connection objects for your organization.

Show connected supplier properties

string

Supplier UUID.

string

Supplier code.

string

Supplier display name.

string

Short description of the supplier, if available.

string

URL of the supplier logo image, if available.

string

ISO 8601 timestamp when the connection was established.

number

required

Number of connected suppliers.

number

required

Remaining supplier budget: the number of new distinct suppliers you can still connect on your plan (maxSuppliers minus the distinct suppliers you have ever connected).

Example

curl https://api.mapping.travel/api/v1/suppliers/my-suppliers \
  -H "X-API-Key: <token>"

GET /api/v1/suppliers/requests

List supplier requests submitted by your organization.

GET https://api.mapping.travel/api/v1/suppliers/requests

Authentication is required.

Use this endpoint to track the status of any suppliers you have requested that are not yet on the platform.

Response

object[]

required

Array of supplier request objects.

Show request properties

string

Request UUID.

string

Name of the requested supplier.

string

Current status of the request (e.g. pending, in_review, completed).

string

ISO 8601 timestamp of when the request was submitted.

number

required

Total number of requests.

Example

curl https://api.mapping.travel/api/v1/suppliers/requests \
  -H "X-API-Key: <token>"

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

GET /api/v1/suppliers

Response

Example

GET /api/v1/suppliers/my-suppliers

Response

Example

GET /api/v1/suppliers/requests

Response

Example

​GET /api/v1/suppliers

​Response

​Example

​GET /api/v1/suppliers/my-suppliers

​Response

​Example

​GET /api/v1/suppliers/requests

​Response

​Example

GET /api/v1/suppliers

Response

Example

GET /api/v1/suppliers/my-suppliers

Response

Example

GET /api/v1/suppliers/requests

Response

Example