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

# List an order's clinics

> Returns the clinics the order’s collection site can change to: clinics that collect every service on the order and serve its location, within `radiusMiles` of the participant’s address. Clinics prioritized for the order’s location come first; the rest follow the tenant’s ordering, nearest first by default. Send one as `clinic` in `PATCH /orders/{id}` to move the order there. Returns 404 when the order does not exist or is outside the token’s access, and 422 when the order’s collection site can no longer change or the participant’s address cannot be searched from. Requires the `order.clinics.list` scope.



## OpenAPI

````yaml api-reference/openapi.json GET /api/v2/orders/{id}/clinics
openapi: 3.1.0
info:
  title: Origin One API
  description: REST API for integrating with the Origin One platform.
  version: '2'
  contact:
    name: Origin One
    url: https://origin.one
    email: support@originone.ai
servers:
  - url: https://api.stage.origin.one
    description: Staging
  - url: https://api.origin.one
    description: Production
security: []
tags:
  - name: agencies
    description: >-
      Regulatory agencies and the job categories they publish; the same for
      every API token.
  - name: jobCategories
    description: >-
      Job categories an agency publishes; an order with a DOT service under such
      an agency names one, required when the agency publishes more than one.
  - name: tenants
    description: >-
      Tenants your API token can act in: the direct child tenants of its own
      tenant that it has access to. Prefix a route with `/tenants/{tenantId}` to
      act in one.
  - name: clinics
    description: Collection sites where participants are tested.
  - name: companies
    description: Companies linked to your API token.
  - name: locations
    description: Company locations.
  - name: orders
    description: >-
      Drug and alcohol test orders: create them and follow their services to a
      result.
  - name: packages
    description: Packages of services that can be ordered.
  - name: services
    description: Services available to your API token.
paths:
  /api/v2/orders/{id}/clinics:
    get:
      tags:
        - orders
      summary: List an order’s clinics
      description: >-
        Returns the clinics the order’s collection site can change to: clinics
        that collect every service on the order and serve its location, within
        `radiusMiles` of the participant’s address. Clinics prioritized for the
        order’s location come first; the rest follow the tenant’s ordering,
        nearest first by default. Send one as `clinic` in `PATCH /orders/{id}`
        to move the order there. Returns 404 when the order does not exist or is
        outside the token’s access, and 422 when the order’s collection site can
        no longer change or the participant’s address cannot be searched from.
        Requires the `order.clinics.list` scope.
      operationId: listOrderClinics
      parameters:
        - name: id
          required: true
          in: path
          description: Unique identifier of the resource.
          schema:
            type: string
            example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
            description: Unique identifier of the resource.
        - name: limit
          required: false
          in: query
          description: Number of items per page (max 20).
          schema:
            default: 10
            type: integer
            minimum: 1
            maximum: 20
            description: Number of items per page (max 20).
            example: 10
        - name: page
          required: false
          in: query
          description: Page of results to return (1-based).
          schema:
            default: 1
            type: integer
            minimum: 1
            maximum: 10000
            description: Page of results to return (1-based).
            example: 1
        - name: radiusMiles
          required: false
          in: query
          description: Search radius from the participant’s address, in miles (max 100).
          schema:
            default: 25
            type: number
            minimum: 1
            maximum: 100
            description: Search radius from the participant’s address, in miles (max 100).
            example: 25
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClinicList'
        '400':
          description: The request failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The bearer token is missing, invalid, or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The API token lacks the required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: The resource does not exist or is outside the API token’s access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: The operation is not allowed in the resource’s current state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearer: []
components:
  schemas:
    ClinicList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ClinicSummary'
          description: Items on this page.
        limit:
          type: integer
          description: Number of items per page.
          example: 10
        page:
          type: integer
          description: Current page number (1-based).
          example: 1
        total:
          type: integer
          description: Number of matching items across all pages.
          example: 1
      required:
        - data
        - limit
        - page
        - total
    Error:
      type: object
      properties:
        error:
          type: string
          description: HTTP status reason phrase.
          example: Bad Request
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                anyOf:
                  - type: string
                    enum:
                      - backgroundCheckIntegrationNotConfigured
                      - badRequest
                      - conflict
                      - insufficientScope
                      - internalError
                      - invalidElement
                      - invalidFormat
                      - invalidKey
                      - invalidScheduleStrategy
                      - invalidState
                      - invalidType
                      - invalidUnion
                      - invalidValue
                      - linkRequiredBackground
                      - notFound
                      - notMultipleOf
                      - required
                      - scheduleClinicExcludedByFeeCap
                      - scheduleConfiguredClinicUnavailable
                      - tooBig
                      - tooManyRequests
                      - tooSmall
                      - unauthenticated
                      - unrecognizedKeys
                  - type: string
                description: >-
                  Machine-readable error code. New codes may be added; treat
                  unknown codes by `statusCode`.
                example: tooSmall
              detail:
                type: string
                description: Human-readable explanation.
                example: 'Too small: expected number to be >=1'
              meta:
                description: Additional machine-readable context.
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
              source:
                description: Present only when a request field is at fault.
                type: object
                properties:
                  pointer:
                    type: string
                    description: JSON pointer to the request field at fault.
                    example: /page
                required:
                  - pointer
            required:
              - code
              - detail
          description: One entry per problem found.
        statusCode:
          type: integer
          description: HTTP status code.
          example: 400
      required:
        - error
        - errors
        - statusCode
    ClinicSummary:
      type: object
      properties:
        address:
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
          description: Postal address; null when the clinic has none.
        id:
          type: string
          description: Unique identifier of the clinic.
          example: '42'
        name:
          type: string
          description: Clinic name.
          example: Austin Downtown Clinic
        object:
          type: string
          description: Object type; always `clinic`.
          example: clinic
          enum:
            - clinic
        phone:
          description: Primary phone number.
          example: +1-512-555-0100
          type:
            - string
            - 'null'
        coordinates:
          anyOf:
            - $ref: '#/components/schemas/ClinicCoordinates'
            - type: 'null'
          description: Geographic position; null when the clinic has none on file.
        distance:
          $ref: '#/components/schemas/ClinicDistance'
          description: >-
            Distance from the search origin: the search’s coordinates or
            address, or the participant’s address for an order’s clinics.
            Present only on those results.
        isActive:
          type: boolean
          description: Whether the clinic is currently active.
          example: true
        url:
          type: string
          description: Canonical path of this resource, relative to the API origin.
          example: /api/v2/clinics/42
          format: uri-reference
      required:
        - address
        - id
        - name
        - object
        - phone
        - coordinates
        - isActive
        - url
    Address:
      type: object
      properties:
        city:
          description: City or town.
          example: Seattle
          type:
            - string
            - 'null'
        country:
          description: Country code.
          example: US
          type:
            - string
            - 'null'
        line1:
          description: First line of the street address.
          example: 123 Main St
          type:
            - string
            - 'null'
        line2:
          description: Second line of the street address.
          example: Suite 400
          type:
            - string
            - 'null'
        object:
          type: string
          description: Object type; always `address`.
          example: address
          enum:
            - address
        postalCode:
          description: Postal or ZIP code.
          example: '98101'
          type:
            - string
            - 'null'
        state:
          description: State or region code.
          example: WA
          type:
            - string
            - 'null'
      required:
        - city
        - country
        - line1
        - line2
        - object
        - postalCode
        - state
    ClinicCoordinates:
      type: object
      properties:
        lat:
          type: number
          description: Latitude in decimal degrees.
          example: 30.2672
        long:
          type: number
          description: Longitude in decimal degrees.
          example: -97.7431
      required:
        - lat
        - long
    ClinicDistance:
      type: object
      properties:
        miles:
          type: number
          description: Distance from the search origin, in miles.
          example: 1.8
      required:
        - miles
  securitySchemes:
    bearer:
      description: >-
        Origin One API token. Pass it in the Authorization header:
        `Authorization: Bearer <token>`.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.