Skip to main content

LegitApp API

Welcome to the LegitApp Developer Documentation! This guide provides everything you need to integrate LegitApp's powerful authentication and verification capabilities into your platform. Whether you're building a secure marketplace or enhancing user trust, LegitApp offers flexible integration options tailored to your specific workflow.

Developer Portal Access

All integrations are managed through our Developer Portal at https://developer.legitapp.com. Access is granted to approved business accounts only — to request access, please reach out to us at business@legitapp.com.

Authentication Submission Methods​

LegitApp supports three distinct ways to submit items for authentication:

1. Server API​

Integrate LegitApp's services directly into your backend systems using our robust Server API. This method is ideal for developers who want full control over the authentication lifecycle and highly customizable workflows.

2. Customized Web Interface​

Designed for rapid deployment, this method lets your system create a unique authentication intent via our API. Once generated, anyone with the unique link can securely submit photos and information through a LegitApp-hosted interface. This minimizes development overhead while maintaining a seamless user experience.

3. LegitApp App / Web Portal​

The standard LegitApp submission flow, allowing direct manual submission through our native mobile applications or official web portal:

Retrieving Authentication Results​

LegitApp provides two methods for retrieving authentication results, so you can choose the approach that best fits your system:

1. GET Request (Pull)​

Query a completed authentication on demand using one of three identifiers. Each maps to a dedicated endpoint, so you can match results against whichever reference your system already stores. → Get Authentication Detail

  • Authentication ID — The unique, system-generated identifier for each specific authentication.
  • Tag ID — The physical tag associated with the item.
  • User Custom Code — A user-defined reference string that lets you map results to your own internal order IDs.

2. Webhook (Push)​

Receive real-time authentication results automatically, pushed directly to your registered endpoint as events occur. → Receive LegitApp Events in Your Webhook Endpoint

You can also choose which order origins trigger a webhook notification, based on your integration needs:

  • Orders created via API (Default) — Receive events only for orders submitted through the API.
  • Orders created via App — Receive events only for orders submitted through our App.
  • All new orders — Receive events for every order associated with your business account, regardless of submission source.