Tinvio Filings API
Search tax return filings by period, form type, lifecycle status, and tax payable.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tinvio-com:tinvio-com-filings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Tinvio Com Filings API
version: '1.0'
contact:
email: build.with@jaz.ai
name: API Support
url: https://jaz.ai
description: 'Operations tagged Filings across 2 of this provider''s published API definitions: tinvio-com-openapi-original.yaml, tinvio-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.getjaz.com
tags:
- description: Search tax return filings by period, form type, lifecycle status, and tax payable.
name: Filings
paths:
/api/v1/filing-submissions/search:
post:
description: Search tax return filings with filters, sort, and pagination. Filter on period, form type, lifecycle status, tax payable, and due dates, and combine conditions with and, or, andGroup, and orGroup. Results are sorted newest first by creation date unless a sort is supplied, and a sort is required when offset is set.
operationId: search-filing-submission
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PageableResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'402':
description: Payment Required
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- ApiKeyAuth: []
summary: Search Filings
tags:
- Filings
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SearchFilingSubmissionsRequest'
description: Search filters, sort, and pagination.
required: true
servers:
- url: https://api.getjaz.com
components:
schemas:
ErrorResponse:
properties:
error:
allOf:
- $ref: '#/components/schemas/ErrorResponseData'
description: Error details.
type: object
DateExpression:
properties:
between:
description: Match dates between these two dates (exactly two, in YYYY-MM-DD format).
items:
type: string
type: array
eq:
description: Match dates equal to this, in YYYY-MM-DD format.
type: string
gt:
description: Match dates after this, in YYYY-MM-DD format.
type: string
gte:
description: Match dates on or after this, in YYYY-MM-DD format.
type: string
isNotNull:
description: Match records where the date is set. Pass the placeholder date "0001-01-01".
example: '0001-01-01'
type: string
isNull:
description: Match records where the date is not set. Pass the placeholder date "0001-01-01".
example: '0001-01-01'
type: string
lt:
description: Match dates before this, in YYYY-MM-DD format.
type: string
lte:
description: Match dates on or before this, in YYYY-MM-DD format.
type: string
notBetween:
description: Match dates outside these two dates (exactly two, in YYYY-MM-DD format).
items:
type: string
type: array
required:
- between
type: object
BigDecimalExpression:
properties:
eq:
description: Match values equal to this.
type: number
gt:
description: Match values greater than this.
type: number
gte:
description: Match values greater than or equal to this.
type: number
in:
description: Match values equal to any of these.
items:
type: number
maxItems: 100
type: array
inRange:
description: Match values within this inclusive range (exactly two, low then high).
items:
type: number
type: array
lt:
description: Match values less than this.
type: number
lte:
description: Match values less than or equal to this.
type: number
neq:
description: Match values not equal to this.
type: number
notInRange:
description: Match values outside this inclusive range (exactly two, low then high).
items:
type: number
type: array
type: object
TaxTypeNestedFilter:
properties:
categoryCode:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by the tax type's category code.
type: object
SearchFilingSubmissionsRequest:
properties:
filter:
allOf:
- $ref: '#/components/schemas/FilingSubmissionFilter'
description: Filter conditions. Combine with and, or, andGroup, and orGroup for complex queries.
limit:
default: 100
description: Maximum number of results per page (max 1000).
maximum: 1000
minimum: 1
type: integer
offset:
default: 0
description: Zero-indexed row offset into the result set. Sort is required when offset is set.
maximum: 65536
minimum: 0
type: integer
query:
description: 'Structured search query using Jaz search operators. Parsed automatically into filter fields.
Explicit filter fields override query results on conflict.
Example: "status:unpaid AND $500+".'
maxLength: 1000
type: string
sort:
allOf:
- $ref: '#/components/schemas/FilingSubmissionSortFilter'
description: Sort order. Defaults to newest first by creation date. Required when offset is set.
type: object
StringExpression:
properties:
contains:
description: Match values containing this substring.
type: string
endWith:
description: Match values ending with this term (case sensitive).
type: string
eq:
description: Match values equal to this.
type: string
in:
description: Match values equal to any of these.
items:
type: string
maxItems: 100
type: array
isBlank:
description: Match records where the field is null or empty ("true") or neither ("false").
type: string
isNotBlank:
description: Match records where the field is neither null nor empty ("true").
type: string
isNull:
description: Match records where the field is null ("true") or not null ("false").
type: string
likeIn:
description: Match values containing any of these substrings.
items:
type: string
maxItems: 100
type: array
neq:
description: Match values not equal to this.
type: string
notContains:
description: Match values not containing this substring.
type: string
notEndWith:
description: Match values not ending with this term (case sensitive).
type: string
notStartWith:
description: Match values not starting with this term (case sensitive).
type: string
reg:
description: Match values containing any of these terms. This is a substring match, not a regular expression, despite the name.
items:
type: string
maxItems: 100
type: array
startWith:
description: Match values starting with this term (case sensitive).
type: string
required:
- in
- likeIn
- reg
type: object
TaxFormNestedFilter:
properties:
categoryCode:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by the form's category code.
type: object
PageableResponse:
properties:
data:
description: Result rows for the requested page.
totalElements:
description: Total number of records matching the query.
type: integer
totalPages:
description: Total number of pages.
type: integer
type: object
FilingSubmissionSortFilter:
properties:
order:
description: Sort direction, ASC or DESC.
enum:
- ASC
- asc
- DESC
- desc
type: string
sortBy:
description: Fields to sort by, in priority order.
items:
type: string
maxItems: 12
type: array
uniqueItems: true
required:
- order
- sortBy
type: object
IntExpression:
properties:
eq:
description: Match values equal to this.
type: integer
gt:
description: Match values greater than this.
type: integer
gte:
description: Match values greater than or equal to this.
type: integer
in:
description: Match values equal to any of these.
items:
type: integer
maxItems: 100
type: array
inRange:
description: Match values within this inclusive range (exactly two, low then high).
items:
type: integer
type: array
lt:
description: Match values less than this.
type: integer
lte:
description: Match values less than or equal to this.
type: integer
notInRange:
description: Match values outside this inclusive range (exactly two, low then high).
items:
type: integer
type: array
required:
- in
type: object
FilingSubmissionFilter:
properties:
and:
description: Combine with another filter using AND.
type: object
andGroup:
description: Combine filter groups using AND.
items:
type: object
type: array
displayFilingGroupings:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: 'Filter by the period grouping a filing is listed under: MONTHLY, QUARTERLY, ANNUAL, or OTHER.'
filingDueDate:
allOf:
- $ref: '#/components/schemas/DateExpression'
description: Filter by statutory due date, in YYYY-MM-DD format.
formType:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by tax form code, for example 2550Q.
lifecycleStatus:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by lifecycle status, for example READY_TO_FILE, SENT_TO_CLIENT, FILED_AND_PAID, or CANCELLED.
or:
description: Combine with another filter using OR.
type: object
orGroup:
description: Combine filter groups using OR.
items:
type: object
type: array
organizationResourceId:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by organization resource ID.
paymentStatus:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by payment status.
periodEndDate:
allOf:
- $ref: '#/components/schemas/DateExpression'
description: Filter by the last day of the period covered, in YYYY-MM-DD format.
periodStartDate:
allOf:
- $ref: '#/components/schemas/DateExpression'
description: Filter by the first day of the period covered, in YYYY-MM-DD format.
periodType:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: 'Filter by period type: MONTHLY, QUARTERLY, or ANNUAL.'
periodValue:
allOf:
- $ref: '#/components/schemas/IntExpression'
description: Filter by the month (1 to 12) or quarter (1 to 4) within the period year, according to period type.
periodYear:
allOf:
- $ref: '#/components/schemas/IntExpression'
description: Filter by the calendar year of the period covered.
resourceId:
allOf:
- $ref: '#/components/schemas/StringExpression'
description: Filter by filing resource ID.
taxDueAmount:
allOf:
- $ref: '#/components/schemas/BigDecimalExpression'
description: Filter by tax payable on the return.
taxForm:
allOf:
- $ref: '#/components/schemas/TaxFormNestedFilter'
description: Filter by fields on the tax form behind the filing.
taxType:
allOf:
- $ref: '#/components/schemas/TaxTypeNestedFilter'
description: Filter by fields on the tax type.
type: object
ErrorResponseData:
properties:
error_type:
description: Error category, for example validation_error, invalid_request_body, or internal_server_error.
example: validation_error
type: string
errors:
description: Error messages describing what went wrong.
items:
type: string
type: array
type: object
securitySchemes:
ApiKeyAuth:
description: Organization API key. Pass it in the x-jk-api-key header on every request.
in: header
name: x-jk-api-key
type: apiKey
x-refined-from:
- tinvio-com-openapi-original.yaml
- tinvio-com-openapi.yml