---
title: "List the carriers assigned to the calling customer"
url: "https://developer.agentsync.io/apis/contracting-hierarchies-api/versions/40f58935-396e-4da4-8f47-1587041e1b16/operations/listAssignedCarriersV2"
---

> Full API specification: https://developer.agentsync.io/apis/contracting-hierarchies-api/versions/40f58935-396e-4da4-8f47-1587041e1b16.md

# List the carriers assigned to the calling customer

`GET` `/v2/assigned-carriers`

Operation ID: `listAssignedCarriersV2`

Returns the carriers assigned to the calling customer's account as a token-paginated collection, so the customer's configuration can be read in one call. Each carrier carries its type and status names inline. Results are scoped to the caller; another customer's carriers are never returned. Note: `updated_since` filters on the carrier organization's own `updatedAt` and does not reflect assignment-only changes if the carrier record itself did not change.

## Query parameters

- `page_token` (string, optional) - Opaque continuation token from a previous response's `page.nextToken`. Omit for the first page.
- `page_size` (integer, optional) - Maximum number of items to return. Defaults to 25; values outside `[1, 250]` are rejected with `400` (not clamped).
- `updated_since` (string, date-time, optional) - Return only contracts modified at or after this RFC3339 UTC timestamp (inclusive). Modified time tracks any column change, so "modified" does not necessarily mean a business-meaningful change. Best used as a high-water mark for incremental sync: a pagination run is not a point-in-time snapshot, so records updated mid-run may first appear on a later poll.

## Responses

- `200` - A page of assigned carriers.
- `400` - Invalid `page_token`, `page_size`, or `updated_since`.
- `401` - Missing or invalid bearer token.
- `403` - The bearer token is not authorized for this resource.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: AgentSync Contracting & Hierarchies API
  version: v1.7.6
servers:
  - url: https://api.sandbox.agentsync.io/contracting
    description: Sandbox
  - url: https://api.agentsync.io/contracting
    description: Production
paths:
  /v2/assigned-carriers:
    get:
      tags:
        - Assigned Resources
      operationId: listAssignedCarriersV2
      summary: List the carriers assigned to the calling customer
      description: >
        Returns the carriers assigned to the calling customer's account as a
        token-paginated

        collection, so the customer's configuration can be read in one call.
        Each carrier carries its

        type and status names inline. Results are scoped to the caller; another
        customer's carriers are

        never returned.

        Note: `updated_since` filters on the carrier organization's own
        `updatedAt` and does not reflect

        assignment-only changes if the carrier record itself did not change.
      security:
        - oauth2:
            - contracting.contractassignments.read
      parameters:
        - $ref: "#/components/parameters/PageToken"
        - $ref: "#/components/parameters/PageSize"
        - $ref: "#/components/parameters/UpdatedSince"
      responses:
        "200":
          description: A page of assigned carriers.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AssignedCarrierV2Page"
        "400":
          description: Invalid `page_token`, `page_size`, or `updated_since`.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
        "401":
          description: Missing or invalid bearer token.
        "403":
          description: The bearer token is not authorized for this resource.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
security:
  - oauth2:
      - contracting.contractassignments.read
components:
  parameters:
    PageToken:
      name: page_token
      in: query
      required: false
      description: >
        Opaque continuation token from a previous response's `page.nextToken`.
        Omit for the first

        page.
      schema:
        type: string
    PageSize:
      name: page_size
      in: query
      required: false
      description: >
        Maximum number of items to return. Defaults to 25; values outside `[1,
        250]` are rejected

        with `400` (not clamped).
      schema:
        type: integer
        minimum: 1
        maximum: 250
        default: 25
    UpdatedSince:
      name: updated_since
      in: query
      required: false
      description: >
        Return only contracts modified at or after this RFC3339 UTC timestamp
        (inclusive). Modified

        time tracks any column change, so "modified" does not necessarily mean a

        business-meaningful change. Best used as a high-water mark for
        incremental sync: a pagination

        run is not a point-in-time snapshot, so records updated mid-run may
        first appear on a later poll.
      schema:
        type: string
        format: date-time
        example: 2026-06-01T00:00:00Z
  schemas:
    AssignedCarrierV2Page:
      type: object
      description: A token-paginated page of assigned carriers (plain envelope, no HAL
        wrappers).
      properties:
        items:
          type: array
          items:
            $ref: "#/components/schemas/AssignedCarrierV2"
        page:
          $ref: "#/components/schemas/PageInfo"
      required:
        - items
        - page
    ApiError:
      type: object
      description: The AgentSync error shape.
      properties:
        message:
          type: string
          description: A human-readable description of the error.
        details:
          type: array
          description: Optional field-level details.
          items:
            type: object
            properties:
              param:
                type: string
              message:
                type: string
      required:
        - message
    AssignedCarrierV2:
      type: object
      description: A carrier assigned to the calling customer's account.
      properties:
        id:
          type: string
          format: uuid
          description: The carrier's identifier.
        name:
          type: string
        tin:
          type: string
          description: Tax identification number.
        npn:
          type: string
          description: National Producer Number.
        naic:
          type: string
          description: NAIC code.
        coCode:
          type: integer
          format: int64
          description: NAIC company code.
        typeId:
          type: string
          format: uuid
        typeName:
          type: string
          description: The carrier's organization type (inlined).
        statusId:
          type: string
          format: uuid
        statusName:
          type: string
          description: The carrier's status (inlined).
        createdAt:
          type: string
          format: date-time
          description: RFC3339 UTC creation timestamp.
        updatedAt:
          type: string
          format: date-time
          description: RFC3339 UTC last-modified timestamp.
      required:
        - id
        - name
    PageInfo:
      type: object
      description: Pagination metadata for a V2 list response.
      properties:
        size:
          type: integer
          description: Number of items returned in this response (equal to items.length).
        nextToken:
          type:
            - string
            - "null"
          description: Opaque continuation token for the next page, or null on the last
            page.
      required:
        - size
        - nextToken
  securitySchemes:
    oauth2:
      type: oauth2
      description: >
        OAuth2 client credentials. The `tokenUrl` below is the SANDBOX token
        endpoint; for production use `https://auth.agentsync.io/oauth2/token`.
        OpenAPI 3.1 permits only one token URL per flow, so both cannot be
        expressed here - see https://developer.agentsync.io/api-authentication
        for the full environment table, how to request credentials, and worked
        token-retrieval examples.
      flows:
        clientCredentials:
          tokenUrl: https://auth.sandbox.agentsync.io/oauth2/token
          scopes:
            contracting.producers.read: Read producers.
            contracting.contracts.read: Read contracts.
            contracting.contractassignments.read: >
              Read contract assignments, assignment changes, assigned carriers,
              products and commission levels, available uplines, responsible
              upline firms, and hierarchies.
```