Skip to main content
GET
https://api.legitmark.com
/
api
/
v2
/
sr
/
{sr_uuid}
cURL
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'
{
  "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
        }
      ]
    }
  }
}

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.

​
Parameter Dependencies

ParameterRequiresReturns
summary—first_line, second_line, thumbnail
user—User who created the SR
service—Service details
outcome—Authentication outcome
item—brand, category, type
sidesitem=trueSides with media URLs
requirementsitem=true + sides=trueUpload progress and completion
Parameters with dependencies have no effect unless their required params are also set.

Path Parameters

​
sr_uuid
string<uuid>
required

Service request UUID

Query Parameters

​
summary
boolean
default:false

Include summary information (first_line, second_line, combined, thumbnail)

​
item
boolean
default:false

Include item details (brand, category, types)

​
sides
boolean
default:false

Include sides with required/optional separation and uploaded media URLs. Requires item=true — this parameter has no effect unless item=true is also specified.

​
requirements
boolean
default:false

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.

​
user
boolean
default:false

Include user information who created the service request

​
service
boolean
default:false

Include service details

​
outcome
boolean
default:false

Include authentication outcome information

Response

Service request retrieved successfully

​
success
boolean
Example:

true

​
rc_hit
boolean

Indicates if the response was served from cache

Example:

true

​
rc_key
string

Cache key used for this response

Example:

"srs:774a98cc8ef875c48650b83c27b10823"

​
message
string
Example:

"The sr was successfully fetched."

​
sr
object

Service request details