Skip to main content
POST
/
api
/
v2
/
sr
Create Service Request
curl --request POST \
  --url https://api.legitmark.com/api/v2/sr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reference_id": "SKU001",
  "service": "service-uuid-1",
  "item": {
    "category": "category-uuid-1",
    "type": "type-uuid-1"
  }
}
'
{
  "success": true,
  "message": "Service request initiated successfully.",
  "data": {
    "uuid": "sr-uuid-for-tracking",
    "reference_id": "SKU001",
    "status": "draft",
    "requirements": {
      "media_requirements": {
        "expected": 2,
        "sides_count": 3,
        "required_count": 2,
        "optional_count": 1
      },
      "side_groups": [
        {
          "uuid": "sidegroup-uuid-1",
          "name": "Essential Views",
          "description": "Required product angles for authentication",
          "lock": false,
          "sides": [
            {
              "uuid": "side-uuid-1",
              "name": "Front",
              "description": "Front view of the product",
              "ordinal": 0,
              "required": true,
              "side_group_id": "sidegroup-uuid-1",
              "overlay_image": "https://cdn.legitmark.com/static/overlays/front-overlay.png",
              "example_image": "https://cdn.legitmark.com/static/examples/front-example.jpg",
              "thumbnail_image": "https://cdn.legitmark.com/static/thumbnails/front-thumb.jpg",
              "active": true
            },
            {
              "uuid": "side-uuid-2",
              "name": "Back",
              "description": "Back view of the product",
              "ordinal": 1,
              "required": true,
              "side_group_id": "sidegroup-uuid-1",
              "overlay_image": "https://cdn.legitmark.com/static/overlays/back-overlay.png",
              "example_image": "https://cdn.legitmark.com/static/examples/back-example.jpg",
              "thumbnail_image": "https://cdn.legitmark.com/static/thumbnails/back-thumb.jpg",
              "active": true
            }
          ]
        },
        {
          "uuid": "sidegroup-uuid-2",
          "name": "Detail Shots",
          "description": "Optional detail views for enhanced verification",
          "lock": false,
          "sides": [
            {
              "uuid": "side-uuid-3",
              "name": "Logo Close-up",
              "description": "Close-up view of the brand logo",
              "ordinal": 0,
              "required": false,
              "side_group_id": "sidegroup-uuid-2",
              "overlay_image": "https://cdn.legitmark.com/static/overlays/logo-overlay.png",
              "example_image": "https://cdn.legitmark.com/static/examples/logo-example.jpg",
              "thumbnail_image": "https://cdn.legitmark.com/static/thumbnails/logo-thumb.jpg",
              "active": true
            }
          ]
        }
      ]
    },
    "created_at": "2024-01-01T00:00:00.000Z"
  }
}

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.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your API key in the format: Bearer leo_xxxxxxxx

Body

application/json
​
reference_id
string
required

Your internal identifier for the item (e.g., SKU, inventory ID, or product code) used to look up the item in your system

Example:

"SKU001"

​
item
object
required
​
uuid
string<uuid>

Service request identifier

​
service
string<uuid>

Service UUID (luxury, sneakers, etc.). Optional — if omitted, auto-resolved based on your organization and item type.

Example:

"service-uuid-1"

Response

Service request initiated successfully with enhanced details

​
success
boolean
Example:

true

​
message
string
Example:

"Service request initiated successfully."

​
data
object
​
metadata
object