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

# Get a ticket link



## OpenAPI

````yaml https://api.select.dev/v2/openapi.json get /ticket-links/{ticket_link_id}
openapi: 3.1.0
info:
  title: SELECT API (v2)
  version: 0.1.0
servers:
  - url: https://api.select.dev/v2
    description: SELECT API v2
security: []
paths:
  /ticket-links/{ticket_link_id}:
    get:
      tags:
        - ticket-links
      summary: Get a ticket link
      operationId: get_ticket_link_route_ticket_links__ticket_link_id__get
      parameters:
        - name: ticket_link_id
          in: path
          required: true
          schema:
            type: string
            title: Ticket Link Id
        - name: x-tenant-id
          in: header
          required: true
          schema:
            type: string
            description: The organization ID the request is scoped to.
            title: X-Tenant-Id
          description: The organization ID the request is scoped to.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TicketLink'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
        '408':
          $ref: '#/components/responses/RequestTimeout'
        '422':
          $ref: '#/components/responses/ValidationFailed'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - HTTPBearer: []
components:
  schemas:
    TicketLink:
      properties:
        id:
          type: string
          title: Id
          description: The unique identifier of the link.
          readOnly: true
          x-terraform-computed: true
        etag:
          type: string
          title: Etag
          description: >-
            Opaque strong ETag for this link. Matches the `ETag` response
            header, and changes whenever the mirrored title, status or assignee
            is refreshed.
          readOnly: true
          x-terraform-computed: true
        srn:
          type: string
          title: Srn
          description: >-
            The canonical SELECT Resource Name (SRN) of the resource the issue
            is linked to. Resolve one from a resource's identifying details with
            `POST /v2/srn/actions/resolve`.
          readOnly: true
          x-terraform-computed: true
        provider:
          type: string
          const: jira
          title: Provider
          description: The ticketing system the issue lives in.
          readOnly: true
          x-terraform-computed: true
        integration_id:
          type: string
          title: Integration Id
          description: Identifier of the ticketing integration the issue belongs to.
          readOnly: true
          x-terraform-computed: true
        ticket_id:
          type: string
          title: Ticket Id
          description: The issue's identifier in the ticketing system.
          readOnly: true
          x-terraform-computed: true
        ticket_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticket Key
          description: The issue's human-readable key, such as `ENG-123`.
          readOnly: true
          x-terraform-computed: true
        ticket_url:
          type: string
          title: Ticket Url
          description: Link to the issue in the ticketing system.
          readOnly: true
          x-terraform-computed: true
        ticket_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticket Title
          description: The issue's summary line.
          readOnly: true
          x-terraform-computed: true
        ticket_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticket Status
          description: The issue's status in the ticketing system, such as `In Progress`.
          readOnly: true
          x-terraform-computed: true
        ticket_assignee:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticket Assignee
          description: Display name of the person the issue is assigned to.
          readOnly: true
          x-doit-confidentiality: customer-data
          x-doit-pii: true
          x-terraform-computed: true
        is_disconnected:
          type: boolean
          title: Is Disconnected
          description: >-
            Whether the issue no longer exists in the ticketing system. A
            disconnected link stays listed so the loss is visible, and its
            title, status and assignee stay as they were at the last successful
            read.
          default: false
          readOnly: true
          x-terraform-computed: true
        sync_time:
          anyOf:
            - type: string
            - type: 'null'
          title: Sync Time
          description: >-
            When the issue's title, status and assignee were last read from the
            ticketing system, as an RFC 3339 UTC timestamp. Those fields reflect
            the issue as of this time, not necessarily its current state.
          readOnly: true
          x-terraform-computed: true
        create_time:
          type: string
          title: Create Time
          description: When the link was created, as an RFC 3339 UTC timestamp.
          readOnly: true
          x-terraform-computed: true
      type: object
      required:
        - id
        - etag
        - srn
        - provider
        - integration_id
        - ticket_id
        - ticket_url
        - create_time
      title: TicketLink
      description: An issue in an external ticketing system, linked to a SELECT resource.
    ProblemDetail:
      additionalProperties: true
      description: >-
        RFC 9457-style error payload, served as ``application/problem+json``.


        ``code`` is the stable, machine-readable identifier — consumers branch
        on it,

        never on ``title``. ``type`` stays ``about:blank``: we keep no per-error

        documentation pages. There is no ``instance``/request-id member (we
        don't run

        access logs). See the flat error-code catalogue in §4 of the standards
        doc.
      properties:
        type:
          default: about:blank
          title: Type
          type: string
        title:
          type: string
          title: Title
        status:
          title: Status
          type: integer
        detail:
          title: Detail
          type: string
        code:
          title: Code
          type: string
        retryable:
          title: Retryable
          type: boolean
        details:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          default: null
          title: Details
      required:
        - title
        - status
        - detail
        - code
        - retryable
      title: ProblemDetail
      type: object
  responses:
    BadRequest:
      description: Bad request
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    Unauthorized:
      description: Unauthorized
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        WWW-Authenticate:
          description: Authentication challenge for the requested resource.
          required: true
          schema:
            type: string
    Forbidden:
      description: Forbidden
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    NotFound:
      description: Not found
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    MethodNotAllowed:
      description: Method not allowed
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        Allow:
          description: HTTP methods supported by the requested resource.
          required: true
          schema:
            type: string
    RequestTimeout:
      description: Request Timeout
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    ValidationFailed:
      description: Validation failed
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    RateLimited:
      description: Rate limited
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          required: true
          schema:
            type: integer
            minimum: 0
    InternalError:
      description: Internal error
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    ServiceUnavailable:
      description: Service unavailable
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          required: true
          schema:
            type: integer
            minimum: 0
  securitySchemes:
    HTTPBearer:
      type: http
      description: Organization API key (sl_…).
      scheme: bearer

````