Client sign in Talk to a specialist
MenuClose
What we do
Who we serve
Our work
Insights
About
Careers
Talk to a specialist connect@tracarta.in · +91 98106 81799
What we do/Clarion/API documentation
ClarionAPI documentation

Your travel GST data, in your own systems.

A simple, read-only API for the data your team sees in Clarion. Pull lines, airline documents and reports straight into your ERP or dashboards.

Read-onlyKeys never change data
7 endpointsLines, documents, reports, uploads
60 / minuteRequests per key
JSONOver HTTPS

Introduction

The Clarion API gives your own systems the same data your team sees in Clarion: reconciled lines, airline invoices and credit notes, reports and uploads. It returns JSON over HTTPS.

The API is read-only. Keys can read your data, never change it.

Read-only
Nothing can be changed
JSON
Over HTTPS only
60 a minute
Requests per key
Base URL
Base URL
https://clarion.tracarta.com/api/v1

Authentication

Create a key in Clarion under Settings → API, and send it with every request in the Authorization header.

A key sees exactly what its owner sees, and nothing more. Each key can be limited to certain data and addresses, and set to expire. Keep keys secret: anyone with a key can read what it can read.

Keys start with clr_live_. If a key is lost, delete it in Clarion and create a new one.

Header
Authorization: Bearer clr_live_YOUR_KEY

Limits

Up to 60 requests a minute per key. If you go over, you get error 429 and a Retry-After header that says how many seconds to wait.

For large pulls, ask for 1,000 lines a page and go through the pages one at a time.

Response
HTTP/1.1 429 Too Many Requests
Retry-After: 12

{
  "error": "rate_limited",
  "message": "Too many requests. Try again in 12 seconds."
}

Errors

Errors come back with a standard HTTP status and a short JSON body that says what went wrong.

StatusMeaning
400Something in the request is not valid, for example a date in the wrong format.
401The key is missing, wrong or has expired.
403The key cannot see this GSTIN or document.
404Nothing found with that ID.
429Too many requests. Wait for the time in Retry-After.
500Something went wrong on our side. Try again; if it keeps happening, tell us.
Response
HTTP/1.1 403 Forbidden

{
  "error": "forbidden",
  "message": "This key cannot see GSTIN 29AAHCH4821K1Z5."
}

Pages of results

Lists come back a page at a time. Use page and per_page to move through them; total tells you how many there are in all.

Response
{
  "total": 1413,
  "page": 2,
  "per_page": 1000,
  "lines": [ ... ]
}
Data

List GSTINs

GEThttps://clarion.tracarta.com/api/v1/gstins

Returns the companies and GSTINs your key can see. Use these values to filter other requests.

Request
curl "https://clarion.tracarta.com/api/v1/gstins" \
  -H "Authorization: Bearer clr_live_YOUR_KEY"
Response
{
  "gstins": [
    {
      "gstin": "27AAHCH4821K1Z9",
      "state": "Maharashtra",
      "company": "Halden Industries Pvt Ltd"
    },
    {
      "gstin": "06AAHCH4821K1Z3",
      "state": "Haryana",
      "company": "Halden Industries Pvt Ltd"
    }
  ]
}
Data

List lines

GEThttps://clarion.tracarta.com/api/v1/lines

Returns the reconciled lines you see in My Data: one line per airline invoice or credit note, with the columns your account is allowed to see. Use it to bring Clarion data into your ERP or dashboards.

Filters
NameTypeWhat it does
gstintextOnly lines for this GSTIN. Leave out for every GSTIN you can see.
from, todateAirline invoice date range, as YYYY-MM-DD.
fytextFinancial year, for example 2026-27.
airlinetextAirline name, for example IndiGo.
typetextinvoice or credit_note.
gstr2btextin_gstr2b, not_in_gstr2b or not_checked.
documentyes / noOnly lines that have, or do not have, their airline document linked.
page, per_pagenumber100 lines a page by default, up to 1,000.
Request
curl "https://clarion.tracarta.com/api/v1/lines?gstin=27AAHCH4821K1Z9&from=2026-10-01" \
  -H "Authorization: Bearer clr_live_YOUR_KEY"
Response
{
  "total": 462,
  "page": 1,
  "per_page": 100,
  "lines": [
    {
      "transaction_id": "HLD-B26160",
      "type": "invoice",
      "gstin": "27AAHCH4821K1Z9",
      "airline": "Air India",
      "airline_gstin": "27ZZACA2281B1Z5",
      "invoice_number": "MH/2627/0026160",
      "invoice_date": "2026-10-30",
      "taxable_value": 42864.00,
      "igst": 0.00,
      "cgst": 2571.84,
      "sgst": 2571.84,
      "gstr2b_status": "in_gstr2b",
      "document_id": "doc_7Hk2Qm9"
    }
  ]
}
Data

Get one line

GEThttps://clarion.tracarta.com/api/v1/lines/{transaction_id}

Returns one line, with everything you see when you open it in My Data, including the passenger, PNR and ticket number where your account can see them.

Path value
NameTypeWhat it does
transaction_idtextThe line’s transaction ID, for example HLD-B26160.
Request
curl "https://clarion.tracarta.com/api/v1/lines/HLD-B26160" \
  -H "Authorization: Bearer clr_live_YOUR_KEY"
Response
{
  "transaction_id": "HLD-B26160",
  "type": "invoice",
  "airline": "Air India",
  "invoice_number": "MH/2627/0026160",
  "invoice_date": "2026-10-30",
  "passenger": "Ms Pooja Shetty",
  "pnr": "KHQMNP",
  "ticket_number": "5469263643243",
  "place_of_supply": "Maharashtra (27)",
  "total_gst": 5143.68,
  "gstr2b_status": "in_gstr2b",
  "document_id": "doc_7Hk2Qm9"
}
Data

Download a document

GEThttps://clarion.tracarta.com/api/v1/documents/{document_id}

Returns the airline’s invoice or credit note as a PDF, exactly as the airline issued it.

Path value
NameTypeWhat it does
document_idtextFrom the document_id on a line.
Request
curl "https://clarion.tracarta.com/api/v1/documents/doc_7Hk2Qm9" \
  -H "Authorization: Bearer clr_live_YOUR_KEY" \
  -o "MH-2627-0026160.pdf"
Response headers
200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="MH-2627-0026160.pdf"
Reports

List reports

GEThttps://clarion.tracarta.com/api/v1/reports

Returns the reconciliation reports TraCarta has added to your account, newest first.

Filters
NameTypeWhat it does
fytextOnly reports for this financial year, for example 2026-27.
Request
curl "https://clarion.tracarta.com/api/v1/reports?fy=2026-27" \
  -H "Authorization: Bearer clr_live_YOUR_KEY"
Response
{
  "reports": [
    {
      "id": "rep_Q2FY2627",
      "title": "Q2 FY 2026-27 reconciliation",
      "period": "Jul-Sep 2026",
      "added_on": "2026-11-07",
      "format": "xlsx",
      "size_bytes": 1992294
    }
  ]
}
Reports

Download a report

GEThttps://clarion.tracarta.com/api/v1/reports/{id}/file

Returns a report as the Excel workbook you would download in My Reconciliation.

Path value
NameTypeWhat it does
idtextThe report’s id, from List reports.
Request
curl "https://clarion.tracarta.com/api/v1/reports/rep_Q2FY2627/file" \
  -H "Authorization: Bearer clr_live_YOUR_KEY" \
  -o "Q2 FY 2026-27 reconciliation.xlsx"
Response headers
200 OK
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="Q2 FY 2026-27 reconciliation.xlsx"
Uploads

List uploads

GEThttps://clarion.tracarta.com/api/v1/uploads

Returns the files your team has sent to TraCarta, and where each one is: received, being processed or done.

Filters
NameTypeWhat it does
statustextreceived, processing or done.
Request
curl "https://clarion.tracarta.com/api/v1/uploads?status=processing" \
  -H "Authorization: Bearer clr_live_YOUR_KEY"
Response
{
  "uploads": [
    {
      "id": "upl_8nT3",
      "name": "Oct 2026 bookings",
      "files": 1,
      "sent_by": "Priya Sharma",
      "sent_on": "2026-11-13",
      "status": "processing"
    }
  ]
}
Need a hand connecting?Our team helps your IT team set up the first pull. support@tracarta.com · +91 98106 81799
Talk to a specialist