Legitmark API Platform Documentation

# 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'

{ "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" } }

Path Parameters

identifier

string

required

Service request identifier - can be UUID, micro_id, legacy_id, or external_id

Response

Service request found successfully

success

boolean

Example:

true

rc_hit

boolean

Indicates if the response was served from cache

Example:

false

message

string

Example:

"A sr was successfully fetched."

details

object

Hide child attributes

details.id

string<uuid>

Service request UUID

Example:

"3acd54ab-1cff-4641-ae93-d9b4941f5a9c"

details.micro_id

string

Short numeric identifier for the service request

Example:

"562280"

details.legacy_id

string | null

Legacy system identifier (if migrated from older system)

Example:

null

details.state

object

Current state of the service request

Hide child attributes

details.state.primary

enum<string>

Primary workflow state

Available options:

DRAFT,

QC,

UNDERWAY,

COMPLETE,

CANCELLED

Example:

"COMPLETE"

details.state.supplement

enum<string> | null

Secondary state indicating authentication status or assignment

Available options:

PENDING,

REJECTED,

ASSIGNED,

APPROVED,

COMPLETE

Example:

"APPROVED"

details.url

string

Direct URL to view the service request

Example:

"https://app.legitmark.com/view?sr=3acd54ab-1cff-4641-ae93-d9b4941f5a9c"

details.document_url

string | null

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

string

Cache key used for this response