Skip to main content
POST
/
api
/
v2
/
sr
{
  "success": true,
  "message": "Service request initiated successfully.",
  "data": {
    "uuid": "sr-uuid-for-tracking",
    "reference_id": "ACTOR_INVENTORY_ID",
    "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://media.legitmark.com/static/overlays/front-overlay.png",
              "example_image": "https://media.legitmark.com/static/examples/front-example.jpg",
              "thumbnail_image": "https://media.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://media.legitmark.com/static/overlays/back-overlay.png",
              "example_image": "https://media.legitmark.com/static/examples/back-example.jpg",
              "thumbnail_image": "https://media.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://media.legitmark.com/static/overlays/logo-overlay.png",
              "example_image": "https://media.legitmark.com/static/examples/logo-example.jpg",
              "thumbnail_image": "https://media.legitmark.com/static/thumbnails/logo-thumb.jpg",
              "active": true
            }
          ]
        }
      ]
    },
    "created_at": "2024-01-01T00:00:00.000Z"
  }
}

Authorizations

x-api-key
string
header
required

API key for application authentication (format: leo_xxxxxxxxx)

x-user-token
string
header
required

Secure user token (Non-PII format: lm_usr_xxxxx) - PROPOSED: Not yet implemented

Body

application/json
reference_id
string
required

Actor's internal reference ID

Example:

"ACTOR_INVENTORY_ID"

service
string<uuid>
required

Service UUID (luxury, sneakers, etc.)

Example:

"service-uuid-1"

item
object
required
uuid
string<uuid>

Service request identifier

Response

Service request initiated successfully with enhanced details

success
boolean
Example:

true

message
string
Example:

"Service request initiated successfully."

data
object
metadata
object