Here you will find everything you need to start using the ComboCards API. First, please request your personal API key from your support manager.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"31637528","collectionId":"e083eb7a-6d24-4173-a40c-2d4ff4ecf3a3","publishedId":"2s9Ykq6fii","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-12-20T15:00:14.000Z"},"item":[{"name":"v1","item":[{"name":"Card","item":[{"name":"Auto-topup card balance","item":[{"name":"Create auto top-up","id":"6d80b045-e227-4056-93d4-7d99365d0840","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true,"content-length":true}},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"Your_api_key"}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"X-API-Key","value":"This endpoint allows you to set up automatic top-up rules for a virtual card.
Auto top-up is only available for cards of type Balance.
card_id required integer - The ID of the virtual card to which the rule applies. Only works for cards with type Balance.
from_user_id required integer - The ID of the user whose account will be debited during top-up. Can be the owner or cardholder.
type required string - Top-up cycle type.
Can be:
limit – triggers when balance is below threshold
\ndaily – daily top-up
\nweekly – weekly top-up
\nmonthly – monthly top-up
\nthreshold required integer - Minimum balance threshold (only required if type = \"limit\").
mode required string - Top-up mode.
Can be:
to – top-up to the specified amount
\nby – top-up by the specified amount
\namount required integer- The amount to be topped up.
Get card’s auto top-up preferences
\n","urlObject":{"protocol":"http","path":["v1","auto_topup","card",":card_id"],"host":["cc-api","actest","pro"],"query":[],"variable":[{"type":"any","value":"1234","key":"card_id"}]}},"response":[{"id":"32bfa38d-6c1d-4d00-83e4-ea4cff7f9685","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"X-API-Key","value":"Delete auto top-up card settings
\n","urlObject":{"protocol":"http","path":["v1","auto_topup","card",":card_id"],"host":["cc-api","actest","pro"],"query":[],"variable":[{"type":"any","value":"1234","key":"card_id"}]}},"response":[{"id":"25cd8026-27fd-4bb9-aebb-1eb74446f9ac","name":"Successful Response","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"},{"key":"X-API-Key","value":"To update the auto top-up settings for a card, use this endpoint.
\n","urlObject":{"protocol":"http","path":["v1","auto_topup",""],"host":["cc-api","actest","pro"],"query":[],"variable":[]}},"response":[{"id":"53696789-c947-4cf9-b5de-37b16fa398d0","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"Accept","value":"application/json"},{"key":"X-API-Key","value":"To get providers you must send a GET request with the parameters given below
\n","urlObject":{"path":["v1","card","get_providers",""],"host":["https://api.combo.cards"],"query":[{"description":{"content":"asc: to sort the data in ascending order.\ndecs: to sort the data in descending order.
\n","type":"text/plain"},"key":"order","value":"asc"},{"key":"sorting","value":"name"}],"variable":[]}},"response":[{"id":"053f32e2-3e30-4482-b92f-34003634a9f2","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"To create a virtual card, you must send a POST request with the parameters given below. Before creating a virtual card, make sure you have enough funds in your account.
\nname required string - Name of a virtual card
amount required integer - The amount with which the card will be created
quantity required integer - Number of cards to be issued.
note optional string - Free-form description.
provider_id required integer - You can see the available provider_ids for issuing cards if you send this request
currency required string - Card currency. Available currency for issuing card you can see there
type required string - Card type. Can be balance or limit . Available types for issuing card you can see there in field available_card_types
limit_rule required string - limit rule for cards. Can be all_time or monthly . Available limit rule for cards you can see there in the available_limit_rule field
secure_3d_password required string - 3ds password for card. Not available for all providers, see this request for more details
When you send a request to create a virtual card, you will see task_id in the response. To find out the current status of the created cards, you will need to send a request with the task_id parameter. The ID of the created card will be returned to you in the response.
\n","urlObject":{"path":["v1","card","create_card",""],"host":["https://api.combo.cards"],"query":[],"variable":[]}},"response":[{"id":"293d6029-6180-4a05-94f7-622a3d2863a3","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"This request is needed to get the result of creating a virtual card.
\nWhen you send a request to create a virtual cards, you will see task_id in the response. To find out the current status of the created cards, you will need to send a Card Create Result Api request with the task_id parameter. The ID of the created card will be returned in the response.
(Required)
\n","type":"text/plain"},"key":"task_id","value":"Used to retrieve information about a specific card.
\nCard status:
\n1 - Active
\n2 - Frozen
\n3 - Blocked
\n4 - Locked
\nID of the created card
\n","type":"text/plain"},"type":"any","value":"123456","key":"card_id"}]}},"response":[{"id":"371bb301-0fcb-4d4d-b24c-653eb080fda5","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Used to retrieve information of all created cards.
\n","urlObject":{"path":["v1","card","get_all_card",""],"host":["https://api.combo.cards"],"query":[{"description":{"content":"(Required)
\n","type":"text/plain"},"key":"sorting","value":"cardholder"},{"description":{"content":"(Required)
\n","type":"text/plain"},"key":"order","value":"asc"},{"key":"page","value":"1"},{"key":"count","value":"100"},{"description":{"content":"1 - Active; 2 - Frozen; 3 - Blocked; 4 - Locked
\n","type":"text/plain"},"key":"state","value":"This endpoint allows you to unfreeze the card. Unfreeze is not available for some providers.
\n","urlObject":{"path":["v1","card","freeze_unfreeze",":card_id"],"host":["https://api.combo.cards"],"query":[],"variable":[{"id":"64501298-cf18-48d9-b912-42101c3760da","description":{"content":"(Required)
\n","type":"text/plain"},"type":"any","value":"Use this endpoint to block a card. This can not be undone.
\n","urlObject":{"path":["v1","card","block",":card_id"],"host":["https://api.combo.cards"],"query":[],"variable":[{"id":"cf3324c8-1d12-4fb1-b61f-ce30d40dee4d","description":{"content":"(Required)
\n","type":"text/plain"},"type":"any","value":"To top up a card with the balance type, use this endpoint.
(Required)
\n","type":"text/plain"},"type":"any","value":"To withdraw funds from a card with a balance type, use this endpoint. Funds return to the main account balance.
(Required)
\n","type":"text/plain"},"type":"any","value":"To change the limit of a card with the limit type, use this endpoint.
(Required)
\n","type":"text/plain"},"type":"any","value":"Endpoints for working with virtual cards.
\nIn Combo Cards, you can issue both balance and limit cards:
\nBefore creating virtual cards, look at the available providers and pay attention to the parameters with which you can create cards
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"Your_api_key"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"a2e2a610-5bc4-4d5f-894a-e0ecb488eb31","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"99bfba79-a4c8-443a-8252-b545b7454082","type":"text/javascript","exec":[""]}}],"_postman_id":"062ae7ae-951b-4c6d-a923-403623726c0f"},{"name":"Transactions","item":[{"name":"By card id","item":[{"name":"By card id","id":"ce267586-01b6-4904-aee2-e761cf9b749c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"Your_api_key"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.combo.cards/v1/card_expenses/:card_id?ts_start=This endpoint outputs a list of transactions incurred by a given card.
\nDefault Filtering:
\n- If the ts_start and ts_end parameters are not provided, transactions from the last 30 days will be selected by default.
\nFiltering Period Limitations:
\n- If ts_start and ts_end are provided, the range between them must not exceed 30 days.
- If the specified period exceeds 30 days, the API will return an error with an appropriate message.
Case-insensitive partial matching using the ILIKE operator.
\n","type":"text/plain"},"key":"merchant","value":"(Required)
\n","type":"text/plain"},"type":"any","value":"This endpoint outputs a list of transactions. If you send a request without the card_id parameter, transactions for all cards will be returned.
\nDefault Filtering:
\n- If the ts_start and ts_end parameters are not provided, transactions from the last 30 days will be selected by default.
\nFiltering Period Limitations:
\n- If ts_start and ts_end are provided, the range between them must not exceed 30 days.
- If the specified period exceeds 30 days, the API will return an error with an appropriate message.
Unix time
\n","type":"text/plain"},"key":"ts_start","value":"Unix time
\n","type":"text/plain"},"key":"ts_end","value":"Available values : id, ts_created
\n","type":"text/plain"},"key":"sorting","value":"Available values : asc, desc
\n","type":"text/plain"},"key":"order","value":"Default value : 1
\n","type":"text/plain"},"key":"page","value":"Default value : 10
\n","type":"text/plain"},"key":"count","value":"Case-insensitive partial matching using the ILIKE operator.
\n","type":"text/plain"},"key":"merchant","value":"Card transactions can have the following statuses:
\nApproved - transaction completed successfully (1)
\nFailed - transaction was rejected for some reason (2)
\nPending - transaction in awaiting confirmation status (3)
\nProcessed - this status is assigned to transactions when a new Approve transaction is created with a link to a Pending transaction, then the Pending transaction moves to Processed (4)
\nReversed - usually this status is assigned to canceled authorizations (5)
\nExpired - expired transaction (6)
\nCard transactions may have the following reasons:
\nCard created - creating a balance card
\nTop up - top up your balance card
\nWithdrawal - withdrawal of funds from a balance card
\nExpense - card expense
\nCard blocked - blocking the card and returning the remaining funds from the card
\nCorrection - correction on the card for any reason
\nRefund - return funds from the card to the user’s balance
\nTransaction flow may vary for some providers. There are two possible flows:
\nIn the first flow, a single Expense transaction changes its status from Pending to Approved.
\nIn the second flow, an Expense transaction in Pending status moves to Processed. When this happens, a new transaction is created in Approved status and linked to the original Pending transaction. The relationship between the two can be seen in the previous_id field of the Approved transaction response.
Use this endpoint to get OTP codes for your cards for the past hour
\n","urlObject":{"path":["v1","users","get_last_otp",""],"host":["https://api.combo.cards"],"query":[],"variable":[]}},"response":[{"id":"ec91d2b6-60cd-4393-bc1e-a9222bb622df","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Use this endpoint to get your current account balance
\n","urlObject":{"path":["v1","users","user_balance",""],"host":["https://api.combo.cards"],"query":[],"variable":[]}},"response":[{"id":"2b8cab23-fdac-45a7-a267-e6ff03d9a01a","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Use this endpoint to retrieve a list of users, with optional filters by user ID, role, and active status.
\n","urlObject":{"path":["v1","users",""],"host":["https://api.combo.cards"],"query":[{"key":"user_id","value":"Returns a list of users with their balance information.
Supports optional filtering by user ID, name, and role.
The response includes user ID, name, role, and account balances (available and hold) in USD and EUR.
You can find the example parameters for webhook payloads in the \"Create webhooks\" section, specifically under the Example subsection.
\n","urlObject":{"path":["v1","webhooks",""],"host":["https://api.combo.cards"],"query":[],"variable":[]}},"response":[{"id":"4a7e5ca0-e6a5-407f-8ea3-b433cb03f7ce","name":"Successful Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example_endpoint.com/notifications/\",\n \"webhook_type\": \"EXPENSE_CREATED\",\n \"comment\": \"test comment\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.combo.cards/v1/webhooks/"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"OK"},{"id":"d691f979-627b-47b1-9d95-4f0fe2822afd","name":"Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example_endpoint.com/notifications/\",\n \"webhook_type\": \"EXPENSE_CREATED\",\n \"comment\": \"test comment\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.combo.cards/v1/webhooks/"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"\"Webhook with type 3 already exists for user\""},{"id":"3c70f4f1-1b1d-46a2-9a24-be945f489008","name":"Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"webhook_type\": \"EXPENSE_CREATED\",\n \"comment\": \"test\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.combo.cards/v1/webhooks/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n \"body\",\n \"url\"\n ],\n \"msg\": \"field required\",\n \"type\": \"value_error.missing\"\n }\n ]\n}"},{"id":"4fa174b4-f43f-405c-8cc1-5241443491a6","name":"Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example_endpoint.com/notifications/\",\n \"comment\": \"test\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.combo.cards/v1/webhooks/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n \"body\",\n \"webhook_type\"\n ],\n \"msg\": \"field required\",\n \"type\": \"value_error.missing\"\n }\n ]\n}"},{"id":"906f522a-3204-488b-93de-21936e4f08a3","name":"Expample payload ONE_TIME_PASSWORD","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"card_ids\": [444],\n \"code\": \"2302\",\n \"last_4_digits\": \"8123\",\n \"ts_spawn\": 1717139383\n}","options":{"raw":{"language":"json"}}},"url":"your_url"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"\n"},{"id":"21b4f7a9-a983-463b-9c8d-ee598467b8b0","name":"Expample payload CARD_CREATED","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 81362,\n \"name\": \"test_rp_webhook\",\n \"card_expire\": \"***\",\n \"card_number\": \"***\",\n \"p_id\": 12,\n \"user_id\": 16,\n \"cvv\": \"***\",\n \"state\": 1,\n \"currency\": \"USD\",\n \"type\": \"limit\",\n \"limit_rule\": \"all_time\",\n \"card_limit\": 20,\n \"expenses\": 0,\n \"pending\": 0,\n \"total\": 0,\n \"expenses_current_day\": 0,\n \"expenses_current_month\": 0,\n \"expenses_previous_month\": 0,\n \"balance\": 0,\n \"limit\": 20,\n \"frozen_by_admin\": false,\n \"frozen_by_negative_balance\": false,\n \"note\": \"test\",\n \"system_note\": null,\n \"secure_3d_password\": null,\n \"per_transaction_limit\": 11.57\n}\n","options":{"raw":{"language":"json"}}},"url":"your_url"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""},{"id":"62e7fba8-eb4c-404f-864f-5f8c46caece1","name":"Expample payload EXPENSE_CREATED","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 2282877,\n \"merchant\": \"combo.cards\",\n \"ts_created\": 1708609022,\n \"amount\": 1,\n \"currency\": \"USD\",\n \"transaction_amount\": 0,\n \"transaction_currency\": \"USD\",\n \"status\": 1,\n \"reason\": \"Top up\",\n \"decline_reason\": null,\n \"description\": \"\",\n \"card_state\": null,\n \"provider_name\": \"US Visa Commercial Credit (485356)\",\n \"provider_id\": 21,\n \"previous_ids\": null,\n \"card_id\": 66303\n}","options":{"raw":{"language":"json"}}},"url":"your_url"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""},{"id":"1febb915-eacd-4b6d-a39b-a5b4b6b7e278","name":"Expample payload EXPENSE_UPDATED","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 2282877,\n \"merchant\": \"merchant name\",\n \"ts_created\": 1708609022,\n \"amount\": 100,\n \"currency\": \"USD\",\n \"transaction_amount\": 100,\n \"transaction_currency\": \"USD\",\n \"status\": 1,\n \"reason\": \"Expense\",\n \"decline_reason\": null,\n \"description\": \"\",\n \"card_state\": 1,\n \"provider_name\": \"US Visa Commercial Credit (485356)\",\n \"provider_id\": 21,\n \"previous_ids\": null,\n \"card_id\": 6630311\n}","options":{"raw":{"language":"json"}}},"url":"your_url"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"a5839015-6459-4ebb-8a20-89533c5455df"},{"name":"Get webhooks","id":"b9179c05-944b-4281-b5af-5897f5efeb93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"Your_api_key"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.combo.cards/v1/webhooks/","description":"This request allows you to retrieve information about created webhooks
\n","urlObject":{"path":["v1","webhooks",""],"host":["https://api.combo.cards"],"query":[],"variable":[]}},"response":[{"id":"3d563a8f-f7ae-4032-97eb-457fbc690032","name":"Get webhooks","originalRequest":{"method":"GET","header":[],"url":"https://api.combo.cards/v1/webhooks/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"url\": \"https://example_endpoint.com/notifications/\",\n \"webhook_type\": \"ONE_TIME_PASSWORD\",\n \"comment\": \"comment\",\n \"state\": \"ACTIVE\",\n \"ts_created\": 1707831514\n },\n {\n \"url\": \"https://example_endpoint.com/notifications/\",\n \"webhook_type\": \"CARD_CREATED\",\n \"comment\": \"comment\",\n \"state\": \"ACTIVE\",\n \"ts_created\": 1707313011\n },\n {\n \"url\": \"https://example_endpoint.com/notifications/\",\n \"webhook_type\": \"EXPENSE_CREATED\",\n \"comment\": \"comment\",\n \"state\": \"ACTIVE\",\n \"ts_created\": 1707313015\n }\n]"}],"_postman_id":"b9179c05-944b-4281-b5af-5897f5efeb93"}],"id":"96718ed1-1afd-42ee-a831-0867862dda80","description":"Webhooks serve as real-time notifications for API events.
\nComboCards sends these notifications to the endpoint in your system,
allowing you to process this information. To set up webhooks, send a
POST request with the filled-in data provided below.
Body params(json):
\nurl required string - your endpoint where notifications will be sent
webhook_type required string - type of notifications. For each type of notification, its own endpoint can be configured. ComboCards can send 4 types of notifications:
ONE_TIME_PASSWORD – to configure notifications for OTP code delivery for cards (type 1)
\nCARD_CREATED – to configure notifications for card creation (type 2)
\nEXPENSE_CREATED – to configure notifications for card transactions (type 3)
\nEXPENSE_UPDATED – to configure notifications for updated card transactions (type 4)
You can find the example parameters for webhook payloads in the \"Create webhooks\" section, specifically under the Example subsection.
comment string - a comment in any form
To check how much funds you can transfer, you can use this request, which returns your current available balance:
\ncurrency – the currency of your account (EUR/USD)
\nbank_account_balance – the current balance of your account
\nhold_bank_account_balance – the funds currently on hold (in processing)
\ncommission_percent – the transfer fee, charged to the recipient of the funds
\nTo view your P2P transfer transactions, use this request.
\nYou can filter results using the following parameters:
\nsorting – sorting field, you can sort by: amount, currency, id, receiver_email, state, subcategory, ts_spawn
page – page number for pagination
\ncount – number of records per page
\norder – sort order (asc or desc)
id – filter by transaction ID
\nemail – filter by recipient’s email
\nts_start – filter by start timestamp (Unix time in seconds, e.g., 1758846985)
ts_end – filter by end timestamp (Unix time in seconds, e.g., 1758846985)
currency – filter by transaction currency (USD or EUR)
Default value : id
\n","type":"text/plain"},"key":"sorting","value":"id"},{"description":{"content":"Default value : 1
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Default value : 100
\n","type":"text/plain"},"key":"count","value":"100"},{"description":{"content":"Available values : asc, desc\nDefault value : desc
\n","type":"text/plain"},"key":"order","value":"asc"},{"key":"id","value":"10000"},{"key":"email","value":"example@email.com"},{"key":"ts_start","value":"1758846985"},{"key":"ts_end","value":"1758888265"},{"key":"currency","value":"USD"},{"disabled":true,"key":"","value":""}],"variable":[]}},"response":[{"id":"b1181421-4d7f-4209-8f2c-f252072ce0b4","name":"Get transactions","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://cc-api.actest.pro/v1/p2p/transactions/?sorting=id&page=1&count=100&order=asc&id=10000&email=example@email.com&ts_start=1758846985&ts_end=1758888265¤cy=USD","protocol":"http","host":["cc-api","actest","pro"],"path":["v1","p2p","transactions",""],"query":[{"key":"sorting","value":"id","description":"Default value : id"},{"key":"page","value":"1","description":"Default value : 1"},{"key":"count","value":"100","description":"Default value : 100"},{"key":"order","value":"asc","description":"Available values : asc, desc\nDefault value : desc"},{"key":"id","value":"10000"},{"key":"email","value":"example@email.com"},{"key":"ts_start","value":"1758846985"},{"key":"ts_end","value":"1758888265"},{"key":"currency","value":"USD"},{"key":"","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"objects\": [\n {\n \"id\": 101,\n \"ts_spawn\": 1759132885,\n \"amount\": -1.01,\n \"remains\": 25.86,\n \"not_calculated\": false,\n \"currency\": \"USD\",\n \"subcategory\": \"p2p_transfer\",\n \"state\": \"finished\",\n \"receiver_email\": \"example@email.com\"\n },\n {\n \"id\": 102,\n \"ts_spawn\": 1755010902,\n \"amount\": 100.0,\n \"remains\": 100.0,\n \"not_calculated\": false,\n \"currency\": \"USD\",\n \"subcategory\": \"bank_transfer\",\n \"state\": \"finished\",\n \"receiver_email\": null\n }\n ],\n \"meta\": {\n \"total\": 2,\n \"page\": 1,\n \"count\": 100\n }\n}"}],"_postman_id":"c4b275e4-2cdb-45b7-b220-df532d2213ec"},{"name":"Create transfer","id":"66f0353e-948e-42e8-8870-d536a73601ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"example@email.com\",\n \"amount\": 100.00,\n \"currency\": \"USD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.combo.cards/v1/p2p/create_transfer/","description":"To perform a funds transfer, use this request.
\nYou must include the following required parameters in the body:
\nemail – recipient’s email address
\namount – amount to transfer (minimum value: 1)
currency – currency of the transfer (USD or EUR)
P2P (peer-to-peer) refers to internal transfers between two users, where one user sends funds directly to another without involving external payment systems.
\nThe transfer can only be made to the company owner. Funds are transferred from the user’s dedicated P2P account to the recipient’s main account.
\nP2P transfers are available only if this section is enabled in your personal account. Therefore, before using transfers via API, please request access from our support team.
\n","_postman_id":"87152666-c40f-4601-8d6c-3d414ed3a5a0","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"Available values: USD, EUR
\n","type":"text/plain"},"key":"currency","value":"USD"},{"description":{"content":"If group_id is not used, all transactions available to the current user based on their role will be returned (for example, a Business Owner will see all company transactions, while other roles will see transactions according to their access level)
\n","type":"text/plain"},"key":"group_id","value":"123"},{"description":{"content":"Transaction ID
\n","type":"text/plain"},"key":"id","value":"123"},{"description":{"content":"The value represents a Unix timestamp (in seconds), which indicates the number of seconds that have elapsed since January 1, 1970 (UTC).\nAll timestamps are provided in UTC+0 timezone.\nIf this parameter is not used, the current day’s date will be applied by default.
\n","type":"text/plain"},"key":"ts_end","value":"1759309860"},{"description":{"content":"The value represents a Unix timestamp (in seconds), which indicates the number of seconds that have elapsed since January 1, 1970 (UTC).\nAll timestamps are provided in UTC+0 timezone.\nIf this parameter is not used, the current day’s date will be applied by default.
\n","type":"text/plain"},"key":"ts_start","value":"1759309860"},{"description":{"content":"If user_id is not used, all transactions available to the current user based on their role will be returned (for example, a Business Owner will see all company transactions, while other roles will see transactions according to their access level)
\n","type":"text/plain"},"key":"user_id","value":"123"},{"description":{"content":"Max. limit: 1000
\n","type":"text/plain"},"key":"count","value":"100"},{"description":{"content":"Available values : asc, desc\nDefault value : desc
\n","type":"text/plain"},"key":"order","value":"desc"},{"description":{"content":"Default value : 1
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Available values : id, ts_spawn
\nDefault value : ts_spawn
\n","type":"text/plain"},"key":"sorting","value":"ts_spawn"},{"description":{"content":"Available values:
\nAvailable values:
\nAvailable values:
\nAvailable values:
\nAvailable values:
\nStart date and time of the reporting period in format YYYY-MM-DD HH:mm:ss. The value is expected in UTC+0 by default.
\n","type":"text/plain"},"key":"data_start","value":"2025-01-01 12:00:00"},{"disabled":true,"description":{"content":"End date and time of the reporting period in format YYYY-MM-DD HH:mm:ss. The value is expected in UTC+0 by default.
\n","type":"text/plain"},"key":"date_end","value":"2025-10-01 12:00:00"},{"description":{"content":"The time zone in which the dates should be returned. Standard designations are supported (e.g., UTC, Europe/Moscow, Asia/Tokyo). If the parameter is not specified, UTC is used by default.
\n","type":"text/plain"},"key":"timezone","value":"UTC"}],"variable":[]}},"response":[{"id":"844b58bd-060e-4a37-942e-6e2ab9bbd868","name":"Get transactions","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.combo.cards/v1/transactions/?ts_end=1759484844&ts_start=1759309860","protocol":"https","host":["api","combo","cards"],"path":["v1","transactions",""],"query":[{"key":"currency","value":"USD","description":"Available values: USD, EUR","disabled":true},{"key":"group_id","value":"123","description":"If group_id is not used, all transactions available to the current user will be returned.","disabled":true},{"key":"id","value":"123","description":"Transaction ID","disabled":true},{"key":"ts_end","value":"1759484844","description":"The value represents a Unix timestamp (in seconds), which indicates the number of seconds that have elapsed since January 1, 1970 (UTC).\nAll timestamps are provided in UTC+0 timezone.\nIf this parameter is not used, the current day’s date will be applied by default."},{"key":"ts_start","value":"1759309860","description":"The value represents a Unix timestamp (in seconds), which indicates the number of seconds that have elapsed since January 1, 1970 (UTC).\nAll timestamps are provided in UTC+0 timezone.\nIf this parameter is not used, the current day’s date will be applied by default."},{"key":"user_id","value":"123","description":"If user_id is not used, all transactions available to the current user will be returned.","disabled":true},{"key":"count","value":"100","disabled":true},{"key":"order","value":"desc","description":"Available values : asc, desc\nDefault value : desc","disabled":true},{"key":"page","value":"1","description":"Default value : 1","disabled":true},{"key":"sorting","value":"ts_spawn","description":"Available values : id, ts_spawn\nDefault value : ts_spawn","disabled":true},{"key":"category","value":"balance_operation","description":"Available values:\n- balance_operation\n- system_operation\n- user_transfer\n- currency_exchange\n- card_operation\n- commission","disabled":true},{"key":"subcategory","value":"usdt_trc20","description":"Available values:\n- adcombo\n- bank_transfer\n- bug\n- cashback\n- achievement__cashback_declines\n- achievement__cashback_topups\n- p2p_transfer\n- promo\n- referral_income\n- usdc_erc20\n- usdt_erc20\n- usdt_trc20\n- combo_wallet\n- gift_card\n- payout\n- negative_balance\n- funds_transfer\n- block\n- expense\n- card_refund\n- topup\n- withdrawal\n- payroll\n- approved_transaction\n- card_block\n- card_topup\n- card_creation\n- card_maintenance_fee\n- card_withdrawal\n- declined_transaction\n- fx_markup_fee\n- funds_deposit\n- funds_withdrawal\n- micro_transaction\n- pending_transaction\n- transfer_vault\n- currency_exchange\n- rollback\n- achievement__custom","disabled":true},{"key":"direction","value":"income","description":"Available values:\n- income\n- withdrawal","disabled":true},{"key":"initiator","value":"system","description":"Available values:\n- admin\n- manual\n- system\n- rule","disabled":true},{"key":"state","value":"initial","description":"Available values:\n- initial\n- finished\n- rollbacked\n- processing_rollbacking\n- cancelled\n- failed","disabled":true},{"key":"timezone","value":"UTC","description":"The time zone in which the dates should be returned. Standard designations are supported (e.g., UTC, Europe/Moscow, Asia/Tokyo). If the parameter is not specified, UTC is used by default.","type":"text","disabled":true},{"key":"data_start","value":"2025-01-01 12:00:00","description":"Start date and time of the reporting period in format YYYY-MM-DD HH:mm:ss. The value is expected in UTC+0 by default.","disabled":true},{"key":"date_end","value":"2025-10-01 12:00:00","description":"End date and time of the reporting period in format YYYY-MM-DD HH:mm:ss. The value is expected in UTC+0 by default.\n","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"objects\": [\n {\n \"amount\": 100,\n \"card_expense_merchant\": null,\n \"card_id\": 1001,\n \"card_name\": null,\n \"card_number\": null,\n \"cost_by_provider\": null,\n \"currency\": \"USD\",\n \"from_info\": \"ComboCards\",\n \"id\": 34620,\n \"remained_balance\": 436.35,\n \"to_info\": \"User Name USD account\",\n \"ts_spawn\": 1759752455,\n \"date\": \"2025-10-06 12:07:35\",\n \"timezone\": \"UTC\",\n \"user_comment\": \"\",\n \"user_id\": 100,\n \"user_name\": \"User Name\",\n \"original_amount\": null,\n \"original_currency\": null,\n \"category\": \"balance_operation\",\n \"direction\": \"income\",\n \"initiator\": \"admin\",\n \"state\": \"finished\",\n \"subcategory\": \"bank_transfer\"\n }\n ],\n \"meta\": {\n \"total\": 1,\n \"page\": 1,\n \"count\": 100\n }\n}"},{"id":"91e9fbb5-2955-4905-9d6f-1415c5422d13","name":"Validation Error","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.combo.cards/v1/transactions/?currency=USD&group_id=123&id=123&ts_end=1759309860&ts_start=1759309860&user_id=123&count=100&order=desc&page=1&sorting=ts_spawn&category=balance_operation&subcategory=usdt_trc20&direction=income&initiator=system&state=initial&data_start=2025-01-01 12:00:00&timezone=UTC","host":["https://api.combo.cards"],"path":["v1","transactions",""],"query":[{"key":"currency","value":"USD","description":"Available values: USD, EUR"},{"key":"group_id","value":"123","description":"If group_id is not used, all transactions available to the current user based on their role will be returned (for example, a Business Owner will see all company transactions, while other roles will see transactions according to their access level)"},{"key":"id","value":"123","description":"Transaction ID"},{"key":"ts_end","value":"1759309860","description":"The value represents a Unix timestamp (in seconds), which indicates the number of seconds that have elapsed since January 1, 1970 (UTC).\nAll timestamps are provided in UTC+0 timezone.\nIf this parameter is not used, the current day’s date will be applied by default."},{"key":"ts_start","value":"1759309860","description":"The value represents a Unix timestamp (in seconds), which indicates the number of seconds that have elapsed since January 1, 1970 (UTC).\nAll timestamps are provided in UTC+0 timezone.\nIf this parameter is not used, the current day’s date will be applied by default."},{"key":"user_id","value":"123","description":"If user_id is not used, all transactions available to the current user based on their role will be returned (for example, a Business Owner will see all company transactions, while other roles will see transactions according to their access level)"},{"key":"count","value":"100","description":"Max. limit: 1000"},{"key":"order","value":"desc","description":"Available values : asc, desc\nDefault value : desc"},{"key":"page","value":"1","description":"Default value : 1"},{"key":"sorting","value":"ts_spawn","description":"Available values : id, ts_spawn\n\nDefault value : ts_spawn"},{"key":"category","value":"balance_operation","description":"Available values:\n- balance_operation\n- system_operation\n- user_transfer\n- currency_exchange\n- card_operation\n- commission"},{"key":"subcategory","value":"usdt_trc20","description":"Available values:\n- adcombo\n- bank_transfer\n- bug\n- cashback\n- achievement__cashback_declines\n- achievement__cashback_topups\n- p2p_transfer\n- promo\n- referral_income\n- usdc_erc20\n- usdt_erc20\n- usdt_trc20\n- combo_wallet\n- gift_card\n- payout\n- negative_balance\n- funds_transfer\n- block\n- expense\n- card_refund\n- topup\n- withdrawal\n- payroll\n- approved_transaction\n- card_block\n- card_topup\n- card_creation\n- card_maintenance_fee\n- card_withdrawal\n- declined_transaction\n- fx_markup_fee\n- funds_deposit\n- funds_withdrawal\n- micro_transaction\n- pending_transaction\n- transfer_vault\n- currency_exchange\n- rollback\n- achievement__custom"},{"key":"direction","value":"income","description":"Available values:\n- income\n- withdrawal"},{"key":"initiator","value":"system","description":"Available values:\n- admin\n- manual\n- system\n- rule"},{"key":"state","value":"initial","description":"Available values:\n- initial\n- finished\n- rollbacked\n- processing_rollbacking\n- cancelled\n- failed"},{"key":"data_start","value":"2025-01-01 12:00:00","description":"Start date and time of the reporting period in format YYYY-MM-DD HH:mm:ss. The value is expected in UTC+0 by default."},{"key":"date_end","value":"2025-10-01 12:00:00","description":"End date and time of the reporting period in format YYYY-MM-DD HH:mm:ss. The value is expected in UTC+0 by default.\n","disabled":true},{"key":"timezone","value":"UTC","description":"The time zone in which the dates should be returned. Standard designations are supported (e.g., UTC, Europe/Moscow, Asia/Tokyo). If the parameter is not specified, UTC is used by default."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n \"query\",\n \"ts_start\",\n \"date_start\"\n ],\n \"msg\": \"ts_start and date_start can't be used together.\",\n \"type\": \"value_error\"\n }\n ]\n}"}],"_postman_id":"93d51a10-556d-4775-ac8d-4bdc7ed7353f"}],"id":"25d57d24-7063-40fe-b732-5c6cc81c6bcf","description":"This request can be used to retrieve transactions related to the movement of funds in your account balance.
\nThe visibility of transactions depends on the user’s role:
\n