> ## 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 Full SR > Retrieve a service request by UUID with optional related data. ## Parameter Dependencies | Parameter | Requires | Returns | |-----------|----------|--------| | `summary` | — | first_line, second_line, thumbnail | | `user` | — | User who created the SR | | `service` | — | Service details | | `outcome` | — | Authentication outcome | | `item` | — | brand, category, type | | `sides` | `item` | Sides with media URLs | | `requirements` | `item` + `sides` | Upload progress and completion | > Parameters with dependencies have no effect unless their required params are also set. ## Parameter Dependencies | Parameter | Requires | Returns | | -------------- | -------------------------- | ------------------------------------ | | `summary` | — | first\_line, second\_line, thumbnail | | `user` | — | User who created the SR | | `service` | — | Service details | | `outcome` | — | Authentication outcome | | `item` | — | brand, category, type | | `sides` | `item=true` | Sides with media URLs | | `requirements` | `item=true` + `sides=true` | Upload progress and completion | Parameters with dependencies have no effect unless their required params are also set. ## OpenAPI ````yaml /openapi.json get /api/v2/sr/{sr_uuid} 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/v2/sr/{sr_uuid}: get: tags: - Service Requests summary: Get Full SR description: >- Retrieve a service request by UUID with optional related data. ## Parameter Dependencies | Parameter | Requires | Returns | |-----------|----------|--------| | `summary` | — | first_line, second_line, thumbnail | | `user` | — | User who created the SR | | `service` | — | Service details | | `outcome` | — | Authentication outcome | | `item` | — | brand, category, type | | `sides` | `item` | Sides with media URLs | | `requirements` | `item` + `sides` | Upload progress and completion | > Parameters with dependencies have no effect unless their required params are also set. operationId: getServiceRequestV2 parameters: - name: sr_uuid in: path required: true schema: type: string format: uuid description: Service request UUID example: 8e61c991-553a-4a58-9eb6-561b64c11908 - name: summary in: query required: false schema: type: boolean default: false description: >- Include summary information (first_line, second_line, combined, thumbnail) - name: item in: query required: false schema: type: boolean default: false description: Include item details (brand, category, types) - name: sides in: query required: false schema: type: boolean default: false description: >- Include sides with required/optional separation and uploaded media URLs. **Requires `item=true`** — this parameter has no effect unless `item=true` is also specified. - name: requirements in: query required: false schema: type: boolean default: false description: >- Include media requirements (counts and fulfillment status) for the service request. **Requires both `item=true` AND `sides=true`** — this parameter has no effect unless both are specified. - name: user in: query required: false schema: type: boolean default: false description: Include user information who created the service request - name: service in: query required: false schema: type: boolean default: false description: Include service details - name: outcome in: query required: false schema: type: boolean default: false description: Include authentication outcome information responses: '200': description: Service request retrieved 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: true rc_key: type: string description: Cache key used for this response example: srs:774a98cc8ef875c48650b83c27b10823 message: type: string example: The sr was successfully fetched. sr: type: object description: Service request details properties: uuid: type: string format: uuid description: Service request identifier example: 7a19de11-0e00-4a89-8d00-72f525178edc active: type: boolean description: Whether the service request is active example: true migrated: type: boolean description: >- Whether the service request was migrated from legacy system example: false micro_id: type: string description: Short numeric identifier example: '997869' legacy_id: type: string nullable: true description: Legacy system identifier example: null external_id: type: string nullable: true description: External reference ID from partner system example: C26010307 Chanel CC Brooch Gold Rhinestone 23 tab: type: string enum: - DRAFT - QC - UNDERWAY - COMPLETE - CANCELLED description: Current tab/workflow state example: COMPLETE source: type: string description: Source application example: flagship partner_code: type: string nullable: true description: Partner code if submitted via partner integration example: null metadata: type: object description: Additional metadata key-value pairs additionalProperties: type: string 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 example: APPROVED summary: type: object description: Summary information (included when summary=true) properties: first_line: type: string description: Primary summary line (usually type) example: Brooch second_line: type: string description: Secondary summary line (usually brand) example: Chanel combined: type: string description: Combined summary example: Brooch - Chanel thumbnail: type: string format: uri nullable: true description: Thumbnail image URL example: >- https://cdn.legitmark.com/sr/7a19de11-0e00-4a89-8d00-72f525178edc/1f2c80a2-0169-4520-be8c-4a94f6cc7b06.jpg?version=IeLygn6Ky_fJ_HjvpB5bCQFOVeAekVW2 size: type: string nullable: true description: Item size if applicable condition: type: string nullable: true description: Item condition alternative_name: type: string nullable: true description: Alternative name for the item certificate_url: type: string format: uri nullable: true description: URL to the Certificate of Authenticity PDF example: >- https://cdn.legitmark.com/document/certificate/997869_legitmark_certificate_20260204011614.pdf item: type: object description: Item details (included when item=true) properties: type: type: string description: Item type example: undefined model: type: string nullable: true description: Item model brand: type: object properties: uuid: type: string format: uuid name: type: string example: Chanel media: type: string format: uri example: >- https://cdn.legitmark.com/static/brands/chanel.svg sides: type: array items: type: string description: Brand-specific side UUIDs nullable: true types: type: object properties: uuid: type: string format: uuid name: type: string example: Brooch media: type: string format: uri sides: type: array items: type: string description: Type-specific side UUIDs category: type: object properties: uuid: type: string format: uuid name: type: string example: Jewelry media: type: string format: uri sides: type: array items: type: string format: uuid description: Category-specific side UUIDs sides: $ref: '#/components/schemas/SidesResponse' description: >- Sides organized by required/optional with uploaded media (included when sides=true) example: success: true rc_hit: true rc_key: srs:ce73b739a84b2bbb8727e2b1ad211f5d message: The sr was successfully fetched. sr: uuid: 8e61c991-553a-4a58-9eb6-561b64c11908 active: true migrated: false micro_id: '178168' legacy_id: null external_id: SAMPLE-BARCODE-SKU123 tab: COMPLETE source: api partner_code: null metadata: {} state: primary: COMPLETE supplement: APPROVED summary: first_line: Footwear second_line: Sneakers combined: Footwear Sneakers thumbnail: >- https://cdn.legitmark.com/sr/8e61c991-553a-4a58-9eb6-561b64c11908/_v/33ce80ed-d22a-4ef6-b99c-09c06a3d2ee4/medium-contain.webp size: null condition: null alternative_name: null certificate_url: >- https://media.legitmark.com/document/certificate/178168_legitmark_certificate_20251122060559.pdf item: type: undefined model: null brand: null types: uuid: 95e428c2-7c4f-11ef-a623-02595575faeb name: Sneakers media: >- https://cdn.legitmark.com/types/95e428c2-7c4f-11ef-a623-02595575faeb.png sides: [] category: uuid: 25ed7133-f230-4d64-850d-0cfc698e2931 name: Footwear media: >- https://cdn.legitmark.com/categories/25ed7133-f230-4d64-850d-0cfc698e2931.png sides: - f47ac10b-58cc-4372-a567-0e02b2c3d479 - bf98166d-7119-47f0-a4c5-88d67a28e3e6 - 33ce80ed-d22a-4ef6-b99c-09c06a3d2ee4 sides: required: - uuid: ec883c70-f896-47c9-81b6-8d6ff0b5856a name: Interior Size Tag or Stamp description: A photo of the size tag within the sneaker ordinal: 1 overlay_image: >- https://media.legitmark.com/static/sides/footwear/interior-size-tag-or-stamp.png example_image: null thumbnail_image: >- https://media.legitmark.com/static/sides/footwear/interior-size-tag-or-stamp.png required: true active: true side_group_id: 17062000-af27-4d47-b712-6d27b2556f96 media_url: [] is_thumbnail: false - uuid: 4a10bea5-a89c-4489-bba0-e55d8950b8dd name: Outer Sides description: A photo captured from above of both outer sides ordinal: 2 overlay_image: >- https://media.legitmark.com/static/sides/sneakers-base/outer-sides.png example_image: null thumbnail_image: >- https://media.legitmark.com/static/sides/sneakers-base/outer-sides.png required: true active: true side_group_id: 17062000-af27-4d47-b712-6d27b2556f96 media_url: [] is_thumbnail: false optional: - uuid: e35a64e1-2629-4c4a-8e9c-9e9840db725e name: Box Label description: >- Take a straight, clear photo of the label or branding on the box ordinal: 10 overlay_image: null example_image: null thumbnail_image: >- https://media.legitmark.com/static/sides/footwear/box-label.png required: false active: true side_group_id: 17062000-af27-4d47-b712-6d27b2556f96 media_url: [] is_thumbnail: false '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Service request not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: 404 timestamp: '2026-02-04T00:00:00.000Z' message: Unable to find the service request. '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' security: [] x-codeSamples: - lang: typescript label: SDK source: >- import { Legitmark } from 'legitmark'; const legitmark = new Legitmark('leo_your_api_key'); const { sr } = await legitmark.sr.get('8e61c991-553a-4a58-9eb6-561b64c11908', { summary: true, item: true, sides: true, requirements: true, }); console.log(sr.summary.first_line); // "Footwear" console.log(sr.sides.required.length); // 8 - lang: python label: Python source: |- import requests response = requests.get( 'https://api.legitmark.com/api/v2/sr/8e61c991-553a-4a58-9eb6-561b64c11908', headers={'Authorization': 'Bearer leo_your_api_key'}, params={ 'summary': 'true', 'item': 'true', 'sides': 'true', 'requirements': 'true', }, ) sr = response.json()['sr'] print(f"Item: {sr['summary']['first_line']}") # "Footwear" print(f"Required sides: {len(sr['sides']['required'])}") # 8 - lang: curl label: cURL source: >- curl 'https://api.legitmark.com/api/v2/sr/8e61c991-553a-4a58-9eb6-561b64c11908?summary=true&item=true&sides=true&requirements=true' \ -H 'Authorization: Bearer leo_your_api_key' components: schemas: SidesResponse: type: object description: V2 sides response structure with required and optional sides separated properties: required: type: array description: Array of required sides that must have images for authentication items: $ref: '#/components/schemas/ImageSideV2' optional: type: array description: >- Array of optional sides that can provide additional authentication evidence items: $ref: '#/components/schemas/ImageSideV2' 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 ImageSideV2: type: object description: Extended side object with V2 fields including uploaded media required: - uuid - name - ordinal - required properties: uuid: type: string format: uuid description: Side identifier example: d5768e36-8197-11ef-be55-028adb369789 legacy_id: type: integer description: Legacy system identifier example: 0 name: type: string description: Side name example: Front ordinal: type: integer description: Display order within the group example: 1 side_group_id: type: string format: uuid description: ID of the side group this side belongs to nullable: true example: d441d889-53c5-11f0-9948-06fb0f2a63e5 overlay_image: type: string format: uri description: Overlay template image URL nullable: true example: null example_image: type: string format: uri description: Example image URL showing how to take this angle nullable: true example: null thumbnail_image: type: string format: uri description: Thumbnail image URL for this side nullable: true example: >- https://cdn.legitmark.com/static/sides/accessories/accessories-front.png description: type: string description: Detailed description of what image to capture example: >- Clear image of the front-facing side of the item showing overall shape, design, and material. required: type: boolean description: Whether this side is required for authentication example: true active: type: boolean description: Whether this side is active example: true created_at: type: string format: date-time description: Creation timestamp example: '2024-10-03T14:57:39.000Z' updated_at: type: string format: date-time description: Last update timestamp example: '2025-07-12T15:32:57.000Z' media_url: type: array description: >- Array of uploaded media for this side. Empty if no images have been uploaded. items: $ref: '#/components/schemas/MediaUrl' is_thumbnail: type: boolean description: >- Whether this side's image is used as the thumbnail for the service request example: false MediaUrl: type: object description: Media URL object containing image information for a side properties: id: type: integer description: Media ID within the side example: 1 url: type: string format: uri description: Full URL to the image with version parameter example: >- https://cdn.legitmark.com/sr/7a19de11-0e00-4a89-8d00-72f525178edc/151933bf-4ae8-4cd1-8548-991dba09d99e.jpg?version=ATMgayO1WxUF5RX3plZgEBLItkMM.wWe version_string: type: string description: Version identifier for cache busting example: ATMgayO1WxUF5RX3plZgEBLItkMM.wWe last_modified_date: type: string format: date-time description: Last modification timestamp of the media example: '2026-02-04T00:12:23.000Z' deleted: type: boolean description: Whether the media has been deleted example: false is_latest: type: boolean description: Whether this is the latest version of the media example: true 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 ````