> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapping.travel/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```bash theme={null} theme={null}
GET https://api.mapping.travel/api/v1/suppliers
```

### Response

<ResponseField name="suppliers" type="object[]" required>
  Array of active supplier objects.

  <Expandable title="supplier properties">
    <ResponseField name="id" type="string">
      Unique UUID of the supplier.
    </ResponseField>

    <ResponseField name="code" type="string">
      Short identifier code for the supplier (e.g. `expedia`, `booking`).
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name of the supplier.
    </ResponseField>

    <ResponseField name="description" type="string">
      Short description of the supplier.
    </ResponseField>

    <ResponseField name="logoUrl" type="string">
      URL of the supplier logo image, if available.
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the supplier is currently active on the platform.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number" required>
  Total number of active suppliers returned.
</ResponseField>

### Example

```bash theme={null} theme={null}
curl https://api.mapping.travel/api/v1/suppliers
```

```json theme={null} theme={null}
{
  "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.

```bash theme={null} theme={null}
GET https://api.mapping.travel/api/v1/suppliers/my-suppliers
```

<Note>
  Authentication is required. Include your bearer token in the `Authorization` header.
</Note>

### Response

<ResponseField name="suppliers" type="object[]" required>
  Array of supplier connection objects for your organization.

  <Expandable title="connected supplier properties">
    <ResponseField name="id" type="string">
      Supplier UUID.
    </ResponseField>

    <ResponseField name="code" type="string">
      Supplier code.
    </ResponseField>

    <ResponseField name="name" type="string">
      Supplier display name.
    </ResponseField>

    <ResponseField name="connectedAt" type="string">
      ISO 8601 timestamp when the connection was established.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number" required>
  Number of connected suppliers.
</ResponseField>

### Example

```bash theme={null} theme={null}
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.

```bash theme={null} theme={null}
GET https://api.mapping.travel/api/v1/suppliers/requests
```

<Note>
  Authentication is required.
</Note>

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

### Response

<ResponseField name="requests" type="object[]" required>
  Array of supplier request objects.

  <Expandable title="request properties">
    <ResponseField name="id" type="string">
      Request UUID.
    </ResponseField>

    <ResponseField name="supplierName" type="string">
      Name of the requested supplier.
    </ResponseField>

    <ResponseField name="description" type="string">
      Description provided with the request.
    </ResponseField>

    <ResponseField name="contactEmail" type="string">
      Contact email submitted with the request.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status of the request (e.g. `pending`, `in_review`, `completed`).
    </ResponseField>

    <ResponseField name="submittedAt" type="string">
      ISO 8601 timestamp of when the request was submitted.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number" required>
  Total number of requests.
</ResponseField>

### Example

```bash theme={null} theme={null}
curl https://api.mapping.travel/api/v1/suppliers/requests \
  -H "Authorization: Bearer <token>"
```