List available and connected suppliers

Browse all active suppliers supported by Mapping.Travel, view the suppliers connected to your organization, and check the status of your supplier requests.

Mapping.Travel connects your hotel inventory to a curated set of supplier datasets. The list endpoints let you discover which suppliers the platform supports, see which ones your organization has already 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

suppliers · object[] · required

Array of active supplier objects.

Show supplier properties

id · string

Unique UUID of the supplier.

code · string

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

name · string

Display name of the supplier.

description · string

Short description of the supplier.

logoUrl · string

URL of the supplier logo image, if available.

isActive · boolean

Whether the supplier is currently active on the platform.

total · 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 bearer token in the Authorization header.

Response

suppliers · object[] · required

Array of supplier connection objects for your organization.

Show connected supplier properties

id · string

Supplier UUID.

code · string

Supplier code.

name · string

Supplier display name.

connectedAt · string

ISO 8601 timestamp when the connection was established.

total · number · required

Number of connected suppliers.

Example

curl https://api.mapping.travel/api/v1/suppliers/my-suppliers \
  -H "Authorization: Bearer <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

requests · object[] · required

Array of supplier request objects.

Show request properties

id · string

Request UUID.

supplierName · string

Name of the requested supplier.

description · string

Description provided with the request.

contactEmail · string

Contact email submitted with the request.

status · string

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

submittedAt · string

ISO 8601 timestamp of when the request was submitted.

total · number · required

Total number of requests.

Example

curl https://api.mapping.travel/api/v1/suppliers/requests \
  -H "Authorization: Bearer <token>"