LogoLogo
  • GENERAL
    • Introduction
    • Overview
    • Authentification
    • ENUM description
  • ACQUIRING
    • Customer wallets
    • Invoices
    • Onramp
  • EXCHANGE
    • Crypto exchange
  • PAYOUTS
    • Single Payout
    • Mass Payout
  • WEBHOOKS
    • Overview
    • Types of events
    • Webhook payload
    • Webhook sign check
  • GUIDES
    • General questions
      • What is Calypso Pay?
      • Which blockchains and tokens we support?
    • Calypso UI guides and questions
      • Introduction to Calypso Pay
      • Sandbox mode and limits
      • General
        • How to create new API key
        • How to create an additional account
        • How to add a new asset to account
        • How to add funds to your wallet
        • Protect your withdrawals with additional signatures
        • How to change your top-up address
        • How to use address book
        • How to set up auto currency conversion
        • How to transfer money within Calypso pay
        • Create a webhook
      • Accept Payments via UI
        • How to create an invoice via UI
        • Accept Payments FAQ
      • Make Payments via UI
        • How to create a single payout via UI
        • How to create mass payout via UI
        • Make Payments FAQ
      • Make Exchanges via UI
        • How to exchange one crypto asset to the other
      • Reports
        • How to get reports
        • Report contents description
    • Integration guides and questions
      • Get started with API
      • Use Customer purse via API
        • How create a customer
        • How to get a purse
        • How to get a transaction data
      • Accept Payments via API
        • How to create a Limited Invoice via API
        • How to create a Limited Fiat Invoice via API
        • How to create an Unlimited Invoice via API
        • How to manage interventions via API
        • How to embed invoice data to your payment page
      • Payment widget
        • How to create a limited fiat payment widget via API
        • How to create unlimited payment widget
        • How to embed a payment widget on a web page
      • Make Exchange via API
        • How to create a exchange
        • Get balance information via API
      • Make Payments via API
        • Get balance information via API
        • How to create a single payout via API
        • How to create a mass payout via API
  • API REFERENCE
    • Report API
    • Settlement Payout API
    • Webhook API
    • Payout API
    • Exchange API
    • Fiat API
    • User API
    • Rate API
    • Settlement Wallet API
    • Fiat withdrawal API
    • Account API
    • Currency API
    • Invoice API
    • Settlement Report API
    • Crypto to fiat API
    • Customer Purse API
    • Fiat deposit API
    • Payment Widget API
    • Models
Powered by GitBook
On this page
Export as PDF
  1. API REFERENCE

Report API

PreviousAPI REFERENCENextSettlement Payout API

API for getting reports

  • POSTGet payout report
  • POSTGet invoice report
  • POSTGet incoming report
  • POSTGet fiat report
  • POSTGet exchange report
  • POSTGet balance report

Get payout report

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
400
Bad Request
*/*
500
Internal Server Error
*/*
post
POST /api/v1/report/payout HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "firstDate": "2025-05-23T18:07:48.955Z",
    "lastDate": "2025-05-23T18:07:48.955Z",
    "blockchainList": "text",
    "zoneOffset": {
      "totalSeconds": 1,
      "id": "text",
      "rules": {
        "fixedOffset": true,
        "transitions": [
          {
            "overlap": true,
            "duration": {
              "seconds": 1,
              "zero": true,
              "nano": 1,
              "negative": true,
              "units": [
                {
                  "durationEstimated": true,
                  "timeBased": true,
                  "dateBased": true
                }
              ]
            },
            "gap": true,
            "dateTimeAfter": "2025-05-23T18:07:48.955Z",
            "dateTimeBefore": "2025-05-23T18:07:48.955Z",
            "instant": "2025-05-23T18:07:48.955Z"
          }
        ],
        "transitionRules": [
          {
            "month": "JANUARY",
            "timeDefinition": "UTC",
            "dayOfWeek": "MONDAY",
            "dayOfMonthIndicator": 1,
            "localTime": {
              "hour": 1,
              "minute": 1,
              "second": 1,
              "nano": 1
            },
            "midnightEndOfDay": true
          }
        ]
      }
    }
  }
}
{
  "data": {}
}

Get invoice report

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
400
Bad Request
*/*
500
Internal Server Error
*/*
post
POST /api/v1/report/invoice HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "firstDate": "2025-05-23T18:07:48.955Z",
    "lastDate": "2025-05-23T18:07:48.955Z",
    "blockchainList": "text",
    "zoneOffset": {
      "totalSeconds": 1,
      "id": "text",
      "rules": {
        "fixedOffset": true,
        "transitions": [
          {
            "overlap": true,
            "duration": {
              "seconds": 1,
              "zero": true,
              "nano": 1,
              "negative": true,
              "units": [
                {
                  "durationEstimated": true,
                  "timeBased": true,
                  "dateBased": true
                }
              ]
            },
            "gap": true,
            "dateTimeAfter": "2025-05-23T18:07:48.955Z",
            "dateTimeBefore": "2025-05-23T18:07:48.955Z",
            "instant": "2025-05-23T18:07:48.955Z"
          }
        ],
        "transitionRules": [
          {
            "month": "JANUARY",
            "timeDefinition": "UTC",
            "dayOfWeek": "MONDAY",
            "dayOfMonthIndicator": 1,
            "localTime": {
              "hour": 1,
              "minute": 1,
              "second": 1,
              "nano": 1
            },
            "midnightEndOfDay": true
          }
        ]
      }
    }
  }
}
{
  "data": {}
}

Get incoming report

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
400
Bad Request
*/*
500
Internal Server Error
*/*
post
POST /api/v1/report/incoming HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "firstDate": "2025-05-23T18:07:48.955Z",
    "lastDate": "2025-05-23T18:07:48.955Z",
    "blockchainList": "text",
    "zoneOffset": {
      "totalSeconds": 1,
      "id": "text",
      "rules": {
        "fixedOffset": true,
        "transitions": [
          {
            "overlap": true,
            "duration": {
              "seconds": 1,
              "zero": true,
              "nano": 1,
              "negative": true,
              "units": [
                {
                  "durationEstimated": true,
                  "timeBased": true,
                  "dateBased": true
                }
              ]
            },
            "gap": true,
            "dateTimeAfter": "2025-05-23T18:07:48.955Z",
            "dateTimeBefore": "2025-05-23T18:07:48.955Z",
            "instant": "2025-05-23T18:07:48.955Z"
          }
        ],
        "transitionRules": [
          {
            "month": "JANUARY",
            "timeDefinition": "UTC",
            "dayOfWeek": "MONDAY",
            "dayOfMonthIndicator": 1,
            "localTime": {
              "hour": 1,
              "minute": 1,
              "second": 1,
              "nano": 1
            },
            "midnightEndOfDay": true
          }
        ]
      }
    }
  }
}
{
  "data": {}
}

Get fiat report

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
400
Bad Request
*/*
500
Internal Server Error
*/*
post
POST /api/v1/report/fiat HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "firstDate": "2025-05-23T18:07:48.955Z",
    "lastDate": "2025-05-23T18:07:48.955Z",
    "blockchainList": "text",
    "zoneOffset": {
      "totalSeconds": 1,
      "id": "text",
      "rules": {
        "fixedOffset": true,
        "transitions": [
          {
            "overlap": true,
            "duration": {
              "seconds": 1,
              "zero": true,
              "nano": 1,
              "negative": true,
              "units": [
                {
                  "durationEstimated": true,
                  "timeBased": true,
                  "dateBased": true
                }
              ]
            },
            "gap": true,
            "dateTimeAfter": "2025-05-23T18:07:48.955Z",
            "dateTimeBefore": "2025-05-23T18:07:48.955Z",
            "instant": "2025-05-23T18:07:48.955Z"
          }
        ],
        "transitionRules": [
          {
            "month": "JANUARY",
            "timeDefinition": "UTC",
            "dayOfWeek": "MONDAY",
            "dayOfMonthIndicator": 1,
            "localTime": {
              "hour": 1,
              "minute": 1,
              "second": 1,
              "nano": 1
            },
            "midnightEndOfDay": true
          }
        ]
      }
    }
  }
}
{
  "data": {}
}

Get exchange report

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
400
Bad Request
*/*
500
Internal Server Error
*/*
post
POST /api/v1/report/exchange HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "firstDate": "2025-05-23T18:07:48.955Z",
    "lastDate": "2025-05-23T18:07:48.955Z",
    "blockchainList": "text",
    "zoneOffset": {
      "totalSeconds": 1,
      "id": "text",
      "rules": {
        "fixedOffset": true,
        "transitions": [
          {
            "overlap": true,
            "duration": {
              "seconds": 1,
              "zero": true,
              "nano": 1,
              "negative": true,
              "units": [
                {
                  "durationEstimated": true,
                  "timeBased": true,
                  "dateBased": true
                }
              ]
            },
            "gap": true,
            "dateTimeAfter": "2025-05-23T18:07:48.955Z",
            "dateTimeBefore": "2025-05-23T18:07:48.955Z",
            "instant": "2025-05-23T18:07:48.955Z"
          }
        ],
        "transitionRules": [
          {
            "month": "JANUARY",
            "timeDefinition": "UTC",
            "dayOfWeek": "MONDAY",
            "dayOfMonthIndicator": 1,
            "localTime": {
              "hour": 1,
              "minute": 1,
              "second": 1,
              "nano": 1
            },
            "midnightEndOfDay": true
          }
        ]
      }
    }
  }
}
{
  "data": {}
}

Get balance report

post

Permission annotations:

Header parameters
KeystringRequired
SignstringRequired
Body

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses
200
OK
*/*
400
Bad Request
*/*
500
Internal Server Error
*/*
post
POST /api/v1/report/balance HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "firstDate": "2025-05-23T18:07:48.955Z",
    "lastDate": "2025-05-23T18:07:48.955Z",
    "blockchainList": "text",
    "zoneOffset": {
      "totalSeconds": 1,
      "id": "text",
      "rules": {
        "fixedOffset": true,
        "transitions": [
          {
            "overlap": true,
            "duration": {
              "seconds": 1,
              "zero": true,
              "nano": 1,
              "negative": true,
              "units": [
                {
                  "durationEstimated": true,
                  "timeBased": true,
                  "dateBased": true
                }
              ]
            },
            "gap": true,
            "dateTimeAfter": "2025-05-23T18:07:48.955Z",
            "dateTimeBefore": "2025-05-23T18:07:48.955Z",
            "instant": "2025-05-23T18:07:48.955Z"
          }
        ],
        "transitionRules": [
          {
            "month": "JANUARY",
            "timeDefinition": "UTC",
            "dayOfWeek": "MONDAY",
            "dayOfMonthIndicator": 1,
            "localTime": {
              "hour": 1,
              "minute": 1,
              "second": 1,
              "nano": 1
            },
            "midnightEndOfDay": true
          }
        ]
      }
    }
  }
}
{
  "data": {}
}