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

# Get SR Summary

> Look up a service request by any of its identifiers: UUID, micro_id, legacy_id, or external_id. This is a **public endpoint** that does not require authentication.



## OpenAPI

````yaml /openapi.json get /api/sr/find/{identifier}
openapi: 3.1.0
info:
  title: Legitmark Partner API
  description: Comprehensive partner integration API for Legitmark authentication platform
  version: 2.0.0
  contact:
    name: Legitmark Support
    email: support@legitmark.com
    url: https://legitmark.com
servers:
  - url: https://api.legitmark.com
    description: Production API
security:
  - BearerAuth: []
tags:
  - name: Service Requests
    description: Create, retrieve, and manage authentication service requests.
  - name: Media Management
    description: Upload images for service request authentication.
  - name: Taxonomy
    description: Browse categories, types, brands, models, and services to build requests.
paths:
  /api/sr/find/{identifier}:
    get:
      tags:
        - Service Requests
      summary: Get SR Summary
      description: >-
        Look up a service request by any of its identifiers: UUID, micro_id,
        legacy_id, or external_id. This is a **public endpoint** that does not
        require authentication.
      operationId: findServiceRequest
      parameters:
        - name: identifier
          in: path
          required: true
          schema:
            type: string
          description: >-
            Service request identifier - can be UUID, micro_id, legacy_id, or
            external_id
          examples:
            uuid:
              summary: Using SR UUID
              value: 3acd54ab-1cff-4641-ae93-d9b4941f5a9c
            micro_id:
              summary: Using micro ID
              value: '562280'
            external_id:
              summary: Using external reference ID
              value: 0006429-G
          example: '178168'
      responses:
        '200':
          description: Service request found successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  rc_hit:
                    type: boolean
                    description: Indicates if the response was served from cache
                    example: false
                  message:
                    type: string
                    example: A sr was successfully fetched.
                  details:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: Service request UUID
                        example: 3acd54ab-1cff-4641-ae93-d9b4941f5a9c
                      micro_id:
                        type: string
                        description: Short numeric identifier for the service request
                        example: '562280'
                      legacy_id:
                        type: string
                        nullable: true
                        description: >-
                          Legacy system identifier (if migrated from older
                          system)
                        example: null
                      state:
                        type: object
                        description: Current state of the service request
                        properties:
                          primary:
                            type: string
                            enum:
                              - DRAFT
                              - QC
                              - UNDERWAY
                              - COMPLETE
                              - CANCELLED
                            description: Primary workflow state
                            example: COMPLETE
                          supplement:
                            type: string
                            enum:
                              - PENDING
                              - REJECTED
                              - ASSIGNED
                              - APPROVED
                              - COMPLETE
                            nullable: true
                            description: >-
                              Secondary state indicating authentication status
                              or assignment
                            example: APPROVED
                      url:
                        type: string
                        description: Direct URL to view the service request
                        example: >-
                          https://app.legitmark.com/view?sr=3acd54ab-1cff-4641-ae93-d9b4941f5a9c
                      document_url:
                        type: string
                        nullable: true
                        description: >-
                          Returns a URL to the generated document PDF. If
                          primary_state is complete and supplement_state is
                          approved, the URL points to the Certificate of
                          Authenticity (COA). If primary_state is complete and
                          supplement_state is rejected, the URL points to the
                          Attestation Certificate. Returns null if no
                          certificate has been generated (e.g., cancelled or
                          incomplete requests).
                        example: >-
                          https://cdn.legitmark.com/document/certificate/562280_legitmark_certificate_20260203144612.pdf
                  rc_key:
                    type: string
                    description: Cache key used for this response
              example:
                success: true
                rc_hit: true
                rc_key: srs:74a4dd7b9d6d1dab9690606f18015964
                message: A sr was successfully fetched.
                details:
                  id: 8e61c991-553a-4a58-9eb6-561b64c11908
                  micro_id: '178168'
                  legacy_id: null
                  state:
                    primary: COMPLETE
                    supplement: APPROVED
                  url: >-
                    app.legitmark.com/view?sr=8e61c991-553a-4a58-9eb6-561b64c11908
                  document_url: >-
                    https://media.legitmark.com/document/certificate/178168_legitmark_certificate_20251122060559.pdf
        '400':
          description: Validation error - missing or invalid identifier
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missing_id:
                  summary: Missing identifier parameter
                  value:
                    success: false
                    error:
                      code: 400
                      timestamp: '2024-01-01T00:00:00.000Z'
                      message: Invalid request parameters.
                      details:
                        - code: validation/missing-id
                          message: id is required.
                database_error:
                  summary: Database query error
                  value:
                    success: false
                    error:
                      code: 400
                      timestamp: '2024-01-01T00:00:00.000Z'
                      message: Internal server error.
        '404':
          description: Service request not found with the given identifier
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error:
                  code: 404
                  timestamp: '2024-01-01T00:00:00.000Z'
                  message: Unable to find a certificate with the given id.
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponse'
              example:
                success: false
                error:
                  code: 429
                  timestamp: '2024-01-01T00:00:00.000Z'
                  message: Too many requests. Please try again later.
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                error:
                  code: 500
                  timestamp: '2024-01-01T00:00:00.000Z'
                  message: Internal server error.
      security: []
      x-codeSamples:
        - lang: typescript
          label: SDK
          source: >-
            const { details } = await legitmark.sr.find('997869'); // micro_id
            or UUID
        - lang: curl
          label: cURL
          source: >-
            # Find by UUID

            curl
            'https://api.legitmark.com/api/sr/find/8e61c991-553a-4a58-9eb6-561b64c11908'
            \
              -H 'Authorization: Bearer leo_your_api_key'

            # Find by micro_id

            curl 'https://api.legitmark.com/api/sr/find/997869' \
              -H 'Authorization: Bearer leo_your_api_key'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: integer
            timestamp:
              type: string
              format: date-time
            message:
              type: string
            details:
              type: string
    RateLimitErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: integer
              example: 429
            timestamp:
              type: string
              format: date-time
            message:
              type: string
              example: Rate limit exceeded
            details:
              type: object
              properties:
                limit_type:
                  type: string
                  enum:
                    - partner_level
                    - user_level
                    - endpoint_specific
                  example: partner_level
                current_usage:
                  type: integer
                  example: 1001
                limit:
                  type: integer
                  example: 1000
                reset_time:
                  type: string
                  format: date-time
                  example: '2024-01-01T00:01:00.000Z'
                retry_after_seconds:
                  type: integer
                  example: 60
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token authentication. Use your API key in the format: Bearer
        leo_xxxxxxxx
      x-default: leo_your_api_key_here

````