Developer Platform

REST API Reference

Endpoints, parameters and response shapes

A concise reference for the Theaimart Developer Platform. All paths are relative to:

https://api.theaimart.co/api/v1

Authenticate with a bearer API key. All bodies are JSON.

Listings

MethodPathDescription
GET/appsList your apps
POST/appsCreate an app listing
GET/apps/{id}Get an app
PATCH/apps/{id}Update an app
POST/apps/{id}/buildsUpload a build (multipart)
GET/webapps · POST /webappsWeb app listings
GET/agents · POST /agentsAgent listings

Releases

MethodPathDescription
POST/releasesPublish a release
GET/releases?listing_id=List releases for a listing
POST/releases/{id}/rollbackRoll back to previous

Commerce & insight

MethodPathDescription
GET/analytics/overviewInstalls, revenue, retention
GET/finance/earningsEarnings breakdown
GET/finance/payoutsPayout history
GET/reviews?listing_id=Reviews for a listing
POST/webhooks · DELETE /webhooks/{id}Manage subscriptions

Pagination

List endpoints are cursor‑paginated:

curl "https://api.theaimart.co/api/v1/apps?limit=25&cursor=eyJpZCI6..." \
  -H "Authorization: Bearer $THEAIMART_API_KEY"

{
  "data": [ /* ... */ ],
  "page": { "has_more": true, "next_cursor": "eyJpZCI6..." }
}

Errors

Standard HTTP status codes with a structured body:

{
  "error": {
    "code": "validation_error",
    "message": "pricing.amount must be a positive integer",
    "field": "pricing.amount",
    "status": 400
  }
}
StatusMeaning
200 / 201Success
400Invalid request
401Missing/invalid API key
403Key lacks the required scope
404Resource not found
409Conflict (e.g. duplicate version)
422Semantic validation failed
429Rate limited — back off
5xxServer error — retry with backoff

Monetary amounts are integers in the currency's smallest unit — paise for INR, cents for USD. So { "amount": 49900, "currency": "INR" } is ₹499.00. Always pair amount with currency.

Next