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

# List targets for a given specialization

> Returns a list of supported targets for a given specialization



## OpenAPI

````yaml https://api.perfectreferral.com/v1/openapi.yml get /specializations/{id}/targets
openapi: 3.1.0
info:
  version: 1.0.0
  title: Perfect Referral
  description: Refer patients to the right specialist the first time.
  contact:
    email: support@perfectreferral.com
servers:
  - url: https://api.perfectreferral.com/v1
security:
  - bearerHttpAuthentication: []
tags:
  - name: Practitioner
  - name: Specialization
paths:
  /specializations/{id}/targets:
    get:
      tags:
        - Specialization
      summary: List targets for a given specialization
      description: Returns a list of supported targets for a given specialization
      operationId: listTargetsForSpecialization
      parameters:
        - name: id
          in: path
          required: true
          description: The id corresponding to the specialization to list targets for.
          schema:
            type: string
            format: uuid
        - name: model
          in: query
          required: false
          description: The desired model to use.
          schema:
            type: string
            default: latest
      responses:
        '200':
          description: Expected response to a valid request
          headers:
            X-Ratelimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            X-Ratelimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            X-Ratelimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SpecializationTarget'
              examples:
                cardiology:
                  summary: Targets for cardiology
                  description: >-
                    An example response for an `id` corresponding to the
                    specialization of Cardiology
                  value:
                    - name: Interventional cardiology (coronary angiography and PCI)
                      description: >-
                        Coronary angiography and percutaneous coronary
                        intervention performed by an interventional cardiologist
                        for obstructive CAD or acute coronary syndromes
                        requiring revascularization.
                      ruleOutOnly: false
                      status: predicted
                    - name: >-
                        Cardiac electrophysiology (ablation and complex
                        arrhythmia)
                      description: >-
                        Evaluation and management of atrial fibrillation,
                        supraventricular and ventricular arrhythmias including
                        ablation and rhythm device implantation, managed by a
                        cardiac electrophysiologist.
                      ruleOutOnly: false
                      status: predicted
        '400':
          description: The request was malformed.
          headers:
            X-Ratelimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            X-Ratelimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            X-Ratelimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: '400'
                message: Invalid id format
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: No specialization found for the given id.
          headers:
            X-Ratelimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            X-Ratelimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            X-Ratelimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: '404'
                message: No specialization found for the given id
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
        5XX:
          $ref: '#/components/responses/ServerError'
      security:
        - bearerHttpAuthentication: []
components:
  headers:
    RateLimitRemaining:
      description: Requests left in the current monthly quota window.
      schema:
        type: integer
    RateLimitReset:
      description: Unix time (seconds) when the monthly quota window resets.
      schema:
        type: integer
    RateLimitLimit:
      description: Total requests allowed per monthly quota window.
      schema:
        type: integer
    RetryAfter:
      description: Seconds to wait before retrying.
      schema:
        type: integer
  schemas:
    SpecializationTarget:
      type: object
      required:
        - name
        - description
        - ruleOutOnly
        - status
      properties:
        name:
          type: string
          description: The name of the specialization target.
        description:
          type: string
          description: A description of the specialization target.
        ruleOutOnly:
          type: boolean
          description: >-
            When true, billing data can confidently rule a provider out for this
            target but cannot reliably rule them in. Whether a target can be
            ruled in is determined empirically from the data, not by hand.
        status:
          type: string
          enum:
            - predicted
            - omitted
          description: >-
            Describes whether predictions for this target are included within
            this model.
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: HTTP status error code.
        message:
          type: string
          description: Human-readable error description.
  responses:
    Unauthorized:
      description: API token missing or invalid.
      headers:
        X-Ratelimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-Ratelimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
        X-Ratelimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: '401'
            message: Unauthorized
    TooManyRequests:
      description: >-
        Too many requests. Returned when either the monthly request quota or the
        per-second request-rate limit is exceeded; the `message` field
        distinguishes them ("rate limit exceeded" is the monthly quota, "request
        rate exceeded" is the per-second limit).
      headers:
        X-Ratelimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-Ratelimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
        X-Ratelimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: '429'
            message: Too Many Requests
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: '500'
            message: Unexpected server error
    ServerError:
      description: Server error.
  securitySchemes:
    bearerHttpAuthentication:
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your API token.
      type: http
      scheme: bearer

````