Tax Estimation
Transactions
Address Validation
Customers
Registrations
Products
Nexus
Get Filings By 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.
curl --request GET \
--url https://api.trykintsugi.com/v1/filings/registration/{registration_id} \
--header 'X-API-KEY: <api-key>' \
--header 'x-organization-id: <api-key>'{
"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
}Path Parameters
Unique identifier for the registration associated with the filings.
Query Parameters
Page number
x >= 1Page size
1 <= x <= 100Response
Successfully retrieved filings
Show child attributes
Show child attributes
The start date of the filing period.
The end date of the filing period.
Country code in ISO 3166-1 alpha-2 format (e.g., US).
AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, BN, BG, BF, BI, CV, KH, CM, CA, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, HR, CU, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, SZ, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, CI, JM, JP, JE, JO, KZ, KE, KI, KP, KR, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MK, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, SD, SR, SJ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, ZW, XK, ZZ_EU Unique identifier for the filing.
Identifier for the registration associated with the filing.
Get the filing website URL for this filing's jurisdiction
Filing status. Possible values: UNFILED, FILING, FILED.
UNFILED, FILED, FILING, PAUSED The due date of the filing.
The date the filing was completed, if applicable.
Indicates if the filing was done manually.
The code of the state associated with the filing (e.g., IA, NY).
The name of the state associated with the filing (e.g., Iowa, New York).
The associated JIRA issue key for tracking the filing, if available. Can be null.
Indicates if the filing was auto-approved. Defaults to false.
Indicates the date when filing will be unpaused.
Category of filing. Common values: REGULAR (standard periodic filing), PREPAYMENT (prepayment or estimated tax), AMENDMENT (amended return). Different categories can have overlapping periods.
50User ID of who approved the filing.
Timestamp when the filing was approved.
The calculated amount for the filing. Defaults to 0.00.
Adjusted amount, if any.
Discounts applied to the filing.
Discounts applied to the amount.
Penalties applied to the filing.
Total tax collected during the filing period.
Total sales amount during the filing period.
Total taxable amount during the filing period.
Final amount due for the filing.
Total tax liability for the filing.
Number of non-marketplace transactions. For total, add marketplace_transaction_count.
Number of marketplace transactions associated with the filing.
Notes or comments related to the filing.
The amount of tax remitted.
Return confirmation ID, if applicable.
Payment confirmation ID, if applicable.
Indicates if the filing can be approved.
Currency code for the filing (e.g., USD, CAD).
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SPL, SRD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TVD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMW, ZWD x >= 0x >= 1x >= 1x >= 0curl --request GET \
--url https://api.trykintsugi.com/v1/filings/registration/{registration_id} \
--header 'X-API-KEY: <api-key>' \
--header 'x-organization-id: <api-key>'{
"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
}