# Returns a list of GlobalInsuranceCarriers based on filter criteria

**Query shape:** Prefer a **narrow** filter—combine scoping filters with `lastModified` or date bounds where supported. A very wide date range with no other scoping can **408** (timeout) on large tenants; retry with a smaller window or use cursor pagination (`lastId` with `lastModified`—see parameter descriptions).
**Empty results:** **200** with `data: []` means no GlobalInsuranceCarriers matched; it does not indicate invalid filter values.
**responseFields:** Use only names allowed on this operation (see the `responseFields` parameter). Use `ALL` or the documented flat field list.
**Pagination:** The `page` query parameter is deprecated where `lastId` is supported; **`lastModified` / `lastId`** style pagination is preferred.

Endpoint: GET /v1/globalinsurancecarriers
Version: 191.0.3
Security: bearerAuth, oAuthSandbox

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

  - `oAuthSandbox` (unknown)
    oauth2

## Query parameters:

  - `responseFields` (string)
    A URL-encoded, comma-delimited list of field names to include in the response data. Additionally, the following values are also supported:

ALL - Returns all field names.

  - `filter` (string)
    Filter clauses for globalinsurancecarriers. General grammar and operators: the Public API filter documentation.
**Auto filter:** If you omit a date-limiting filter (such as `lastModified`), the server may apply one automatically; behavior can vary by deployment.
**Keys and operators (this endpoint)**
- `id` (`->`)
- `name` (`==`, `~=`)
- `payorId` (`==`, `~=`)
Examples: `name==MonthlyRecall`, `payorId~=Smith`, `id->[123,124]`.

  - `page` (string)
    Page number for pagination control

  - `pageSize` (string)
    Page size for pagination control

  - `lastId` (string)
    the biggest global insurance carrier ID from previous page

## Header parameters:

  - `Organization-ID` (string, required)
    Organization context for the request. Must match the organization authorized by the access token.

## Response 200:

  - `200` (unknown)
    The request was successful

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (integer)
    Example: 8797768

  - `data.name` (string)

  - `data.payorId` (string)
    Example: 2344

  - `data.url` (string)
    Example: example.com

  - `data.address1` (string)
    Example: 123 example st

  - `data.address2` (string)
    Example: 456 example st

  - `data.city` (string)

  - `data.state` (string)

  - `data.postalCode` (string)
    Example: 21323

  - `data.phonePrimary` (string)
    Example: 1236540987

  - `data.phonePrimaryExt` (string)
    Example: 3248764343

  - `data.phoneFax` (string)
    Example: 1349872323

  - `data.neaPayorId` (string)
    Example: 432

  - `data.acceptElectronicAttachments` (boolean)
    Example: true

  - `data.acceptEligibilities` (boolean)
    Example: true

  - `data.lastModified` (string)
    Example: 2018-07-09T19:00:00.000Z

  - `warnings` (array)

  - `warnings.code` (string)

  - `warnings.title` (string)

  - `warnings.description` (string)

  - `warnings.source` (string)

  - `errors` (array)

  - `meta` (object)

  - `meta.pagination` (object)
    Pagination info
    Example: {"limit":10,"offset":0}

  - `meta.pagination.limit` (integer)
    Example: 10

  - `meta.pagination.offset` (integer)
    Example: 0

  - `meta.pagination.total` (integer)
    Example: 100

## Response 400:

  - `400` (unknown)
    The request was invalid or cannot be processed

## Response 401:

  - `401` (unknown)
    Authentication is required and has failed or has not been provided

## Response 403:

  - `403` (unknown)
    The request is understood, but it has been refused or access is not allowed

## Response 404:

  - `404` (unknown)
    The requested resource is either missing or does not exist

## Response 408:

  - `408` (unknown)
    The server timed out while processing the request

## Response 429:

  - `429` (unknown)
    Rate limit exceeded

## Response 500:

  - `500` (unknown)
    An unexpected error occurred

## Response 200 examples:

  - `default` (unknown)