Getting Started

Everything you need to integrate with the Artsays Artwork Verification API.

Get Your API Key

Request an API key from your Settings page. After admin approval, you'll receive either a sandbox or production key.

Sandbox Key

sk_sandbox_ab3f...c8d2

Returns mock/test data. Safe for development.

Production Key

sk_prod_7e9a...f1b3

Hits real data. Use only in production apps.

Authenticate Your Requests

Include your API key in every request using one of these methods:

Recommendedx-api-key Header

curl -H "x-api-key: sk_prod_your_key" https://ai.artsays.in/api/v1/verify

AlternativeQuery Parameter

curl "https://ai.artsays.in/api/v1/verify?api_key=sk_prod_your_key"

Base URL

https://ai.artsays.in/api/

Make Your First API Call

cURL Example

curl -X GET "https://ai.artsays.in/api/v1/verify" \
  -H "x-api-key: sk_prod_your_key_here"

Postman Setup

1Create a new GET request to https://ai.artsays.in/api/v1/verify
2Go to Headers tab and add x-api-key with your key value
3Click Send and verify you receive a JSON response with success: true

Understand the Response

Success (200)

{
  "success": true,
  "data": { ... }
}

Error (4xx)

{
  "success": false,
  "error": "Invalid API key."
}

Sandbox note: Sandbox responses include extra fields: "test": true and "environment": "sandbox"

Common Mistakes

Problem	Cause	Fix
Missing API Key (401)	No x-api-key header or query param	Add your key to every request
Invalid API Key (401)	Key is wrong, rotated, or revoked	Check key in Settings; request new key if needed
Endpoint Not Allowed (403)	Key not authorized for this endpoint	Contact admin to update allowed endpoints
Rate Limit (429)	Exceeded 60 req/min (or custom limit)	Slow down requests; check Retry-After header
Sandbox returns test data	Using sk_sandbox_ key	Switch to sk_prod_ key for real data

API Scopes

Public Endpoints

No authentication required

API Key Endpoints

Requires x-api-key header

JWT Authenticated Endpoints

Requires Bearer token from login

Rate Limiting

Default: 60 requests/minute per API key (sliding window). Exceeding returns 429 with a Retry-After header. Limits are configurable per client by admin.

All Endpoints

Method	Path	Description	Scope
POST	/api/v1/verify	Submit artwork for AI-assisted authenticity risk analysis.	API Key
GET	/api/v1/verify	Get information about the verify endpoint and its parameters.	API Key
POST	/api/verify-steps	Run individual verification pipeline steps (internal use).	JWT
POST	/api/artworks	Upload a new artwork for verification.	JWT
GET	/api/artworks	Get paginated list of artworks with verification data.	JWT
GET	/api/artworks/:id	Get a single artwork with detailed verification scores.	JWT
POST	/api/artworks/:id	Re-run verification on an existing artwork.	JWT
DELETE	/api/artworks/:id	Delete an artwork and its verification records.	JWT
GET	/api/stats	Get platform-wide verification statistics.	Public
POST	/api/auth/signup	Create a new user account.	Public
POST	/api/auth/login	Authenticate and get a JWT token.	Public
GET	/api/auth/me	Get the currently authenticated user.	JWT
GET	/api/profile	Get the authenticated user's full profile.	JWT
PUT	/api/profile	Update the authenticated user's profile.	JWT
PUT	/api/profile/password	Change the authenticated user's password.	JWT
POST	/api/profile/avatar	Upload a profile avatar image.	JWT
POST	/api/training	Submit human feedback on a verification result for model training.	JWT
GET	/api/training	Get paginated training dataset.	JWT
POST	/api/training/upload	Bulk upload labeled training images.	JWT
GET	/api/training/models	List all active AI verification models.	JWT
GET	/api/training/jobs	List all training job runs.	JWT
POST	/api/training/jobs	Start a new model training job.	JWT
GET	/api/admin/api-clients	List all API clients and pending key requests (admin only).	JWT
POST	/api/admin/api-clients	Admin actions: approve, reject, add, rotate, revoke, suspend, update API clients.	JWT
POST	/api/user/request-api-key	Submit a request for an API key.	JWT
GET	/api/user/request-api-key	Check the status of your API key request.	JWT