List VCN transactions (Coming soon)
🚧 Coming soon — this endpoint is not yet available in Sandbox or Production. The documentation is published so you can prepare your integration; we'll announce in the changelog when it goes live.
Use it to reconcile a booking's payments: lists the transactions of a VCN, identified by the vcnId returned by Create VCN. Paginated and ordered by date descending.
Authentication: in addition to the API key/secret, this endpoint requires mTLS at the transport layer.
Authorization: the vcnId must belong to the authenticated client; a vcnId that belongs to another client returns 404.
curl -X GET "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"transactions": [
{
"transactionId": "txn_01HF8Z3K2QX5",
"status": "SETTLED",
"amount": {
"value": 101,
"currency": "BRL"
},
"date": "2026-06-09T16:02:40Z",
"merchantName": "EXAMPLE AIRLINE",
"merchantCategory": "AIR",
"authorizationCode": "A1B2C3"
}
],
"nextPageStartKey": "eyJsYXN0SWQiOiJ0eG5fMDFIRjhaIn0="
}
{
"error": "Bad Request",
"message": "One or more request parameters are invalid.",
"code": 400,
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"details": [
"The example field must have a value between 5 and 100.",
"Dates must be in YYYY-MM-DD format."
]
}
{
"error": "Unauthorized",
"message": "Invalid or expired access token.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 401
}
{
"error": "Forbidden",
"message": "You do not have permission to perform this operation.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 403
}
{
"error": "Not Found",
"message": "The requested resource was not found.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 404
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred while processing the request.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 500
}
/credit-cards/v1/vcns/{vcnId}/transactionsTarget server for requests. Edit to use your own host.
Bearer token from OAuth 2.0 client credentials. Format: Bearer TOKEN
Bearer TOKENIdentifier of the VCN returned at issuance (the vcnId field).
Maximum number of transactions per page. Minimum: 1, Maximum: 100. Default: 50.
Start date of the queried period (YYYY-MM-DD format).
End date of the queried period (YYYY-MM-DD format).
Optional filter by transaction status.
Opaque pagination token returned in the previous response. Use it exactly as received to fetch the next page.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer TOKEN
Path Parameters
Query Parameters
Maximum number of transactions per page. Minimum: 1, Maximum: 100. Default: 50.
50Optional filter by transaction status.
Opaque pagination token returned in the previous response. Use it exactly as received to fetch the next page.
Responses
Opaque pagination token. Resend it in the nextPageStartKey parameter to fetch the next page. Absent on the last page.