Skip to main content
GET
List tax returns
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
While a filing window is open, a draft is recalculated from the company’s records, and each change raises its version. Without an active tax service, the list carries estimates (is_estimate true) instead of drafts.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Query Parameters

limit
integer
default:50

Page size.

Required range: 1 <= x <= 200
cursor
string

The next_cursor of the previous page.

model
string

Only this form, such as 303.

status
enum<string>

draft: calculated, still recalculated from the records. approved: the owner authorized this exact version. filed: filed, with the administration's reference and receipt when Melso filed it.

Available options:
draft,
approved,
filed

Response

Returns.

data
object[]
required
next_cursor
string | null
required

Pass it as cursor for the next page. null on the last page.