API reference / Get filings by registration id
Get filings by registration id
GET/v1/filings/registration/{registration_id}
The Get Filings By Registration ID API retrieves all filings associated with a specific registration ID. This allows users to query detailed filing information tied to a specific registration record.
Authorization
x-api-keystringRequired
Your secret API key. Include it with every request.
x-organization-idstringRequired
Identifies the organization this request acts on.
Path parameters
registration_idstringRequired
Unique identifier for the registration associated with the filings.
Query
Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.
/v1/filings/registration/{registration_id}?page=<page>&size=<size>pageinteger
Page number
sizeinteger
Page size
Response
itemsFilingRead[]Required
totalintegerRequired
pageintegerRequired
sizeintegerRequired
pagesintegerRequired
200
Successfully retrieved filings
Unauthenticated request.
Resource not found
Validation error
Internal server error
cURL
GET /v1/filings/registration/{registration_id}?page=1&size=50
-H "x-api-key: ***"
-H "x-organization-id: ***"
Example request
https://api.trykintsugi.com/v1/filings/registration/{registration_id}?page=1&size=50
Response
{
"items": [
{
"status": "UNFILED",
"start_date": "2024-10-01",
"end_date": "2024-10-31",
"due_date": "2024-11-20",
"is_manual": false,
"state_code": "FL",
"state_name": "Florida",
"country_code": "US",
"auto_approved": false,
"amount_calculated": "100.00",
"amount_adjusted": "0.00",
"amount_discounts": "0.00",
"amount_fees": "5.00",
"amount_penalties": "0.00",
"amount_tax_collected": "100.00",
"amount_sales": "1000.00",
"amount": "105.00",
"total_tax_liability": "105.00",
"transaction_count": 2,
"tax_remitted": "100.00",
"id": "file_12345",
"registration_id": "regs_12345"
}
],
"total": 1,
"page": 1,
"size": 50,
"pages": 1
}