curl --request GET \
--url https://api.visorfinance.app/v1/spaces/{space_id}/transactions \
--header 'Authorization: Bearer <token>'{
"data": [
{
"account_id": "5d3a9c1e-2b4f-4e6a-8c7d-1f0e9b2a3c45",
"amount": "42.90",
"category_id": "3e9a1b7c-4d2f-4a8e-9b6c-0d1e2f3a4b5c",
"created_at": "2026-10-01T15:31:02Z",
"currency_code": "BRL",
"description": "Padaria",
"id": "9c1e4b2a-7d3f-4e8a-b6c5-1a2b3c4d5e6f",
"ignored": false,
"merchant_name": null,
"notes": null,
"source": "manual",
"status": "posted",
"tag_ids": [],
"transacted_at": "2026-10-01T15:30:00Z",
"type": "debit",
"updated_at": "2026-10-01T15:31:02Z"
}
],
"next_cursor": "MjAyNi0xMC0wMVQxNTozMDowMFp8OWMxZQ"
}{
"errors": [
{
"code": "BAD_REQUEST",
"details": {
"parameter": "include_hidden"
},
"message": "The request is malformed.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "INVALID_TOKEN",
"details": {},
"message": "The personal API token is not valid.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "INSUFFICIENT_SCOPE",
"details": {
"required_scope": "pfm:read"
},
"message": "The personal API token does not grant this operation.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "NOT_FOUND",
"details": {},
"message": "The resource does not exist.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "INVALID_TOKEN",
"details": {},
"message": "<string>",
"request_id": "<string>"
}
]
}{
"errors": [
{
"code": "RATE_LIMITED",
"details": {
"retry_after_seconds": 42
},
"message": "Too many requests. Retry after the number of seconds in Retry-After.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}List transactions
Returns one page of the space’s transactions, newest first (transacted_at descending, then id). Requires the pfm:read scope. Pass next_cursor as after to read the next page; it is null on the last page. Without to_date, the list ends today, so a future-dated transaction appears only when to_date includes its date.
curl --request GET \
--url https://api.visorfinance.app/v1/spaces/{space_id}/transactions \
--header 'Authorization: Bearer <token>'{
"data": [
{
"account_id": "5d3a9c1e-2b4f-4e6a-8c7d-1f0e9b2a3c45",
"amount": "42.90",
"category_id": "3e9a1b7c-4d2f-4a8e-9b6c-0d1e2f3a4b5c",
"created_at": "2026-10-01T15:31:02Z",
"currency_code": "BRL",
"description": "Padaria",
"id": "9c1e4b2a-7d3f-4e8a-b6c5-1a2b3c4d5e6f",
"ignored": false,
"merchant_name": null,
"notes": null,
"source": "manual",
"status": "posted",
"tag_ids": [],
"transacted_at": "2026-10-01T15:30:00Z",
"type": "debit",
"updated_at": "2026-10-01T15:31:02Z"
}
],
"next_cursor": "MjAyNi0xMC0wMVQxNTozMDowMFp8OWMxZQ"
}{
"errors": [
{
"code": "BAD_REQUEST",
"details": {
"parameter": "include_hidden"
},
"message": "The request is malformed.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "INVALID_TOKEN",
"details": {},
"message": "The personal API token is not valid.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "INSUFFICIENT_SCOPE",
"details": {
"required_scope": "pfm:read"
},
"message": "The personal API token does not grant this operation.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "NOT_FOUND",
"details": {},
"message": "The resource does not exist.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}{
"errors": [
{
"code": "INVALID_TOKEN",
"details": {},
"message": "<string>",
"request_id": "<string>"
}
]
}{
"errors": [
{
"code": "RATE_LIMITED",
"details": {
"retry_after_seconds": 42
},
"message": "Too many requests. Retry after the number of seconds in Retry-After.",
"request_id": "F8x2kQ9vXc1AAAAB"
}
]
}Authorizations
Personal API token created in Visor Settings
Path Parameters
A space id from GET /v1/spaces
Query Parameters
First day to include, YYYY-MM-DD, in Brasília time
Last day to include, YYYY-MM-DD, in Brasília time. Defaults to today.
Only transactions of this account
Only transactions of this category
Only transactions with this tag
Only debits or only credits
debit, credit true for only ignored transactions, false for only counted ones. Omit it for both.
Text to find in the description, the merchant name, or the notes
100Transactions per page, 1 to 100. Defaults to 50.
1 <= x <= 100The next_cursor of the previous page. Omit it for the first page.
Was this page helpful?