Getting Started
Authentication
All API requests require authentication via an API key sent in the request header.
API Keys
Generate API keys from your Dashboard → API Keys page. Each key has a prefix of mk_ followed by a unique
token.
Keep your API keys secret. Do not expose them in client-side
code or public repositories.
Making Requests
Include your API key in the Authorization header:
Request Header
Authorization: Bearer mk_your_api_key_hereExample Request
cURL
curl https://api.markidy.com/v1/listings/search \
-H "Authorization: Bearer mk_live_abc123def456"Error Responses
| Status | Description |
|---|---|
401 | Missing or invalid API key |
403 | API key lacks required permissions |
429 | Rate limit exceeded |
Error Response
{
"code": "UNAUTHORIZED",
"error": "Invalid API key"
}