> ## Documentation Index > Fetch the complete documentation index at: https://docs.maxcare.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search payers > Search active payer records owned by this practice, including records without billing codes or patient policies. Requires read:payers. Does not collapse equal names or codes. Keyset paging by source UUID; use detail for a saved inactive selection. ## OpenAPI ````yaml /openapi-v4.json get /payers openapi: 3.0.0 info: title: Max AI Public API description: API for third-party marketplace apps version: '4.0' contact: {} servers: - url: https://api.maxcare.ai/v4 security: [] tags: [] paths: /payers: get: tags: - Payers summary: Search payers description: >- Search active payer records owned by this practice, including records without billing codes or patient policies. Requires read:payers. Does not collapse equal names or codes. Keyset paging by source UUID; use detail for a saved inactive selection. operationId: PayersPublicController_listPayers parameters: - name: q required: false in: query description: >- Search payer names, electronic codes or an exact source payer UUID. Name words match case-insensitively across punctuation. schema: maxLength: 200 type: string - name: cursor required: false in: query description: >- Last source payer UUID from the preceding page. Keep the query unchanged while paging. schema: type: string - name: limit required: false in: query schema: minimum: 1 maximum: 100 default: 25 type: number - name: X-Organization-Id in: header required: true schema: type: string description: Target clinic organization ID responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListPayersSuccessResponse' '400': description: Missing or invalid request parameter content: application/json: schema: $ref: '#/components/schemas/PublicApiBadRequestResponse' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/PublicApiUnauthorizedResponse' '403': description: Insufficient scope content: application/json: schema: $ref: '#/components/schemas/PublicApiForbiddenResponse' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/PublicApiRateLimitResponse' '503': description: EHR integration unavailable content: application/json: schema: $ref: '#/components/schemas/PublicApiServiceUnavailableResponse' security: - api-key: [] components: schemas: ListPayersSuccessResponse: type: object properties: code: type: string description: Response code example: success data: $ref: '#/components/schemas/ListPayersResponseData' required: - code - data PublicApiBadRequestResponse: type: object properties: code: type: string description: Error code example: bad_request message: type: string description: Human-readable error message example: '''id'' must be a valid UUID' trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id PublicApiUnauthorizedResponse: type: object properties: code: type: string description: Error code example: unauthorized message: type: string description: Human-readable error message example: Invalid or missing API key trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id PublicApiForbiddenResponse: type: object properties: code: type: string description: Error code example: forbidden message: type: string description: Human-readable error message example: Insufficient scope trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id PublicApiRateLimitResponse: type: object properties: code: type: string description: Error code example: rate_limit_exceeded message: type: string description: Human-readable error message example: Rate limit exceeded. Maximum 1000 requests per 60 seconds. trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id PublicApiServiceUnavailableResponse: type: object properties: code: type: string description: Error code example: server_unresponsive message: type: string description: Human-readable error message example: EHR integration is not available for this note trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id ListPayersResponseData: type: object properties: payers: type: array items: $ref: '#/components/schemas/ExternalPayerResponse' nextCursor: type: string nullable: true description: >- Use as cursor for the next page; null when exhausted. Results ordered by source UUID. required: - payers - nextCursor ExternalPayerResponse: type: object properties: id: type: string description: >- Opaque MaxAI source payer UUID, in the same raw UUID format on every API version. Identifies a source record, not a worldwide carrier or electronic billing code. name: type: string description: Payer display name payerCode: type: string nullable: true description: Electronic payer code. Preserve leading zeroes; not globally unique. payerCodeType: type: string nullable: true description: Identifier namespace, such as Payer ID or National Plan ID. instanceId: type: string nullable: true description: Opaque source EHR instance UUID. instanceLabel: type: string nullable: true description: Practice's display label for the source instance. isActive: type: boolean description: >- Whether this payer is available for new selections. Historical detail remains readable when inactive. ehrStatus: type: string nullable: true description: >- Source lifecycle: active, inactive, deleted, or null when not reported. required: - id - name - payerCode - payerCodeType - instanceId - instanceLabel - isActive - ehrStatus securitySchemes: api-key: scheme: bearer bearerFormat: JWT type: http description: Marketplace API key ````