API Reference / Checkout Sessions REST

Actions

Lists checkout sessions with filtering and pagination options.

GET/checkout-sessions

Get Checkout sessions

Headers

Authorizationstringrequired

Bearer access token returned by the authentication endpoint.

conomyhq-api-versionstring

v1: empty ; v2: 24-04-2025

Defaultnone, is the first API version

x-api-keystringrequired

The API key used for authentication when making requests to the API Gateway.

User-Agentstringrequired

Identifies the application making the request.

Query parameters

identityIdstring

Owner Identity Id

accountNumberstring

Destination Account Number

statusstring

Checkout session status

startDatestring

(dd/mm/yyyy) Start date filters created Date min

endDatestring

(dd/mm/yyyy) End date filters created Date max

sortstring

Sorts the results by param:asc | param:desc

limitstring

Specifies the maximum number of items to return in a single request.

offsetstring

Skips the input value from the current view

Responses

200Request processed successfully.

paginationobjectrequiredshow 4 properties

Cursor-based pagination metadata (limit, cursor, hasMore).

resultsobject[]requiredshow items

Items from the current page

400Invalid request parameters or payload.

errorobjectshow 2 properties

messagestringnullable

Human-readable message. May be null.

500Unexpected internal server error.

errorobjectshow 2 properties

messagestringnullable

Human-readable message. May be null.

Request

HTTPcurlTypeScriptPythonGoRust

GET /sandbox/checkout-sessions HTTP/1.1
Host: api.conomyhq.com
Authorization: Bearer {ACCESS_TOKEN}
conomyhq-api-version: 24-04-2025
x-api-key: {YOUR_API_KEY}
User-Agent: MyApp/1.0

curl -X GET \
  'https://api.conomyhq.com/sandbox/checkout-sessions' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'conomyhq-api-version: 24-04-2025' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -H 'User-Agent: MyApp/1.0'

const response = await fetch('https://api.conomyhq.com/sandbox/checkout-sessions', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'x-api-key': '{YOUR_API_KEY}',
    'User-Agent': 'MyApp/1.0',
  },
});

const data = await response.json();

import requests

response = requests.get(
    'https://api.conomyhq.com/sandbox/checkout-sessions',
    headers={
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'x-api-key': '{YOUR_API_KEY}',
    'User-Agent': 'MyApp/1.0',
    }
)

data = response.json()

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.conomyhq.com/sandbox/checkout-sessions", nil)
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("User-Agent", "MyApp/1.0")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()

	var data map[string]any
	json.NewDecoder(resp.Body).Decode(&data)
}

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let resp = client
        .get("https://api.conomyhq.com/sandbox/checkout-sessions")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("User-Agent", "MyApp/1.0")
        .send()
        .await?;

    let data: serde_json::Value = resp.json().await?;
    Ok(())
}

Response

200 400 401 403 404 422 500

{
  "pagination": {
    "count": 0,
    "next": 0,
    "previous": 0,
    "total": 0
  },
  "results": [
    {
      "id": "string",
      "paymentConfigs": [
        null
      ],
      "createdAt": "2024-01-15T10:30:00.000Z",
      "status": "ATTEMPT",
      "items": [
        null
      ],
      "currency": "string",
      "preTaxAmount": "string",
      "totalAmount": "string",
      "url": "string",
      "paymentMethodsAllowed": [
        null
      ]
    }
  ]
}

{
  "error": {
    "type": "bad_request",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "unauthorized",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "forbidden",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "not_found",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "validation_error",
    "info": {
      "field": "string",
      "message": "string"
    }
  },
  "message": null
}

{
  "error": {
    "type": "internal_error",
    "info": null
  },
  "message": null
}