Aperçu : Capydra ouvre bientôt. Il n'est pas encore possible de commander.

Capydra
Help Cart
Deal of the week

Capydra API

REST API v1 and an MCP server for programs and AI assistants. Machine-readable: /openapi.json (OpenAPI 3.1).

Selling through Eneba or Driffle already? Coming from Eneba or Driffle maps what you know to our calls.

Getting started

  1. Sign in and open /account/api-keys. Create a key: name, scope (buyer or seller), and the sandbox flag. There you accept the two withdrawal-waiver sentences once (terms version 2026-11-16.1); every order made with the key refers to that acceptance.
  2. The key is shown once. Keep it in an environment variable: export OMK_KEY=omk_test_...
  3. Send it as Authorization: Bearer $OMK_KEY.

MCP (Model Context Protocol)

Endpoint: POST https://capydra.com/mcp, Streamable HTTP, stateless. Send Accept: application/json, text/event-stream. Supported: initialize, notifications/initialized, tools/list, tools/call, ping (and the 2026-07-28 per-request form). Answers come as one server-sent event (data: {...}) or JSON. Without a key the answer is 401.

Calling a tool: {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"elden"}}}

ToolScopeWhat it doesArguments (* required)
search_productsbuyerSearch the Capydra catalogue (games, DLC, gift cards, subscriptions, software keys). Each product shows its cheapest offer with the all-in price for one unit (service fee included), in euro cents. query, category, type, platform, region, limit, offset
get_productbuyerOne product with every offer you can buy: seller, stock, and the all-in price for one unit in euro cents. Use an offer id from here with create_order. product_id*
create_orderbuyerOrders an offer for your account. The two withdrawal-waiver sentences you accepted when the API key was made are stored on the order. With a sandbox key (omk_test_) the test payment is approved at once; with a live key the answer carries pay_url, where the payment is made. Keys are fetched with get_order once delivered. offer_id*, qty, coupon_code, player_id, server, trade_url, type_notice
get_orderbuyerStatus of one of your orders. Once delivered, the first call returns the product keys and logs the view (this is the delivery: an instant refund is no longer possible afterwards). Later calls return keys: null; set show_keys to true to see them again (every view is logged). order_id*, show_keys
list_offerssellerYour offers with status, stock, your net price, the commission and what the buyer pays (euro cents). status
create_offersellerCreates your offer for a catalogue product. price_cents is what you want to receive per unit; the answer shows the commission and the buyer price. One offer per product; change it with update_price. product_id*, price_cents*, fulfilment, status, hand_delivery_hours, hand_amount
upload_stocksellerAdds product keys to one of your manual offers. Keys are stored encrypted and never shown back; a key the platform already knows (from any seller) is refused and counted as a duplicate. offer_id*, keys*
update_pricesellerSets a new "price I want to receive" for one of your offers; commission and buyer price are recomputed. offer_id*, price_cents*
get_limitssellerYour seller level, what you may do per day (offers, keys, highest price), what you used, offers on hold, the API rate limit, the sandbox status of your declared-stock API and the caps of the bulk tools. Call this before bulk work.
match_productssellerFinds our product id for rows of your supplier feed: ean, steam_app_id, sku or name, with platform and region. confidence exact or high gives best; none gives candidates and a reason. Never list on a guess. items*
bulk_create_offerssellerCreates up to 20 offers in one call. DRY RUN BY DEFAULT: nothing is written unless you send dry_run: false. First call it with dry_run (or leave it out), show the person the results, then call again with dry_run: false. Each item: product_id (or ean / steam_app_id / sku / name with platform and region), price_cents you want to receive. Every item gets its own result; one bad item never stops the others. dry_run, items*
bulk_update_pricessellerChanges the price of up to 50 of your offers. DRY RUN BY DEFAULT: nothing is written unless you send dry_run: false. The dry run shows the new buyer prices and any review hold. dry_run, items*
upload_stock_jobsellerBig key upload (up to 10000 keys) as a background job for one of your manual offers. Answers at once with a job id; check it with get_job. Bad lines become per-item errors by index; keys are never shown back. offer_id*, keys*
get_jobsellerStatus of one of your upload jobs: counts, the first per-item errors, the key batch and orders delivered from it. job_id*

Endpoints

account catalogue orders seller webhooks mcp admin other

account

Your key and the legal texts.

GET /api/v1/me

Who am I: user, key scope, sandbox flag and the stored waiver acceptance.

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/me" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/keys/rotate

Rotate the key you call with: a new key with the same name, scope, mode, permissions, IP allowlist and expiry length (in this answer only). The old key keeps working for overlap_hours (default 24, max 168), then expires. Keys expire after 365 days unless chosen otherwise (1 to 730 days on /account/api-keys); GET /api/v1/me shows expires_at, permissions and ip_allowlist. Do not send an Idempotency-Key here.

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/api/v1/keys/rotate" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"overlap_hours":24}'

POST /api/v1/keys/signing

Require signed requests for the key you call with (HTTP Message Signatures, RFC 9421, Ed25519). Send the base64 of your 32-byte Ed25519 public key. From then on every request with this key needs Content-Digest (when there is a body), Signature-Input: sig1=("@method" "@target-uri" "content-digest");created=<unix s>;nonce="<random>";keyid="<key id>";alg="ed25519" and Signature: sig1=:<base64>:, created within 5 minutes, each nonce once. Turning it off needs the keys page while signed in.

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/api/v1/keys/signing" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"public_key":"MCowBQYDK2VwAyEA...(base64 of the 32 raw bytes)"}'

catalogue

Products, offers and prices.

GET /api/v1/quote

Price quote after every price modifier (price breaks, membership, coupon).

Auth: none

ParameterInDescription
offer_idqueryOffer id.
qtyqueryQuantity.
couponqueryCoupon code.
curl -s "https://capydra.com/api/v1/quote?offer_id=off_house_elden_ring&qty=1"

GET /api/v1/trust/sellers/{id}

Public trust summary of a seller: level, badge, completed orders, volume tier, payout hold.

Auth: none

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/trust/sellers/sel_house"

GET /api/v1/categories

Product categories.

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/categories" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/products

Search products. Each carries its cheapest offer with the all-in price (service fee included).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
queryqueryWords in name or platform.
categoryqueryCategory slug.
typequerygame, dlc, giftcard, subscription, software, game_currency, account_topup, game_gold, skin, account, ai_subscription, ai_credit.
platformquerye.g. Steam.
regionquerye.g. EU.
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/products?query=elden" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/products/{id}

One product (id or slug) with every offer you can buy.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/products/elden-ring-steam-eu" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/products/{id}/offers

The offers of a product, cheapest all-in price first.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/products/prd_elden_ring/offers" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/offers/{id}

One offer with its price for a quantity.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
qtyqueryQuantity to price (default 1).
curl -s "https://capydra.com/api/v1/offers/off_house_elden_ring?qty=2" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/catalog/match

Find our product id from your supplier feed: ean, steam_app_id, sku or name, plus platform and region. confidence exact (EAN or SKU, one product) or high (Steam app id or name, with platform and region, one product left) gives best; none gives candidates and a reason (several_editions, send_platform_and_region, ...). Never list on a guess.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
eanqueryEAN-8/12/13/14.
steam_app_idquerySteam app id of the game.
skuqueryStore or publisher SKU.
namequeryProduct name as in your feed.
platformquerySteam, Xbox, PlayStation, Nintendo Switch, GOG, EA app, ...
regionqueryEU, GLOBAL or DE.
typequerygame, dlc, giftcard, subscription, software, game_currency, account_topup, game_gold, skin, account, ai_subscription, ai_credit.
curl -s "https://capydra.com/api/v1/catalog/match?steam_app_id=990080&name=Hogwarts%20Legacy&platform=Steam&region=EU" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/catalog/match:batch

Up to 100 match queries in one call, a result per item (as GET /api/v1/catalog/match).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
batch *pathstring
curl -s -X POST "https://capydra.com/api/v1/catalog/match:batch" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"items":[{"ref":"feed-1","ean":"5051892236921","platform":"Steam","region":"EU"},{"ref":"feed-2","name":"Forza Horizon 5","platform":"Steam","region":"GLOBAL"}]}'

orders

Buying, keys, refunds, evidence.

GET /api/v1/orders

Your orders, newest first. A sandbox key lists only sandbox orders, a live key only live ones.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
statusqueryOnly orders with this status.
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/orders" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/orders

Order an offer. waiver1 and waiver2 must be true (or the exact sentences); with an API key the key's stored acceptance is referenced too, and the order is written in its language. auto_pay approves the test payment at once (sandbox keys, or test mode).

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/api/v1/orders" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"offer_id":"off_house_elden_ring","qty":1,"waiver1":true,"waiver2":true,"auto_pay":true}'

GET /api/v1/orders/{id}

One order (no keys). pay_url is set while a live order waits for payment.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/orders/{id}/reveal

Show the delivered keys. The first view needs consent: true; every view is logged (KEY_VIEWED).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/reveal" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"consent":true}'

POST /api/v1/orders/{id}/confirm

"Key works": confirms a delivered order.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/confirm" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/orders/{id}/refund

Instant full refund while no key was revealed.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/refund" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

GET /api/v1/orders/{id}/evidence

Evidence: stored waiver texts and every order event with IP, user agent, time, channel and terms version.

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/evidence" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/trust/reports

Report a problem with one of your orders: kind key_invalid, key_used or other; a key report needs a revealed key (otherwise use the instant refund).

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/api/v1/trust/reports" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"order_id":"ord_xxxxxxxxxxxxxxxx","kind":"key_invalid","text":"Steam says the key is not valid."}'

seller

Seller-scope keys: offers, prices, stock, orders.

GET /api/v1/seller/limits

Your limits (offers, keys per day, open exposure, price pace) and the use of the last 24 hours, plus the API rate limit of this key.

Auth: seller-scope API key or signed-in seller

curl -s "https://capydra.com/api/v1/seller/limits" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/endpoint/verify-domain

Check the DNS TXT record that proves your delivery endpoint's domain is yours.

Auth: seller-scope API key or signed-in seller

curl -s -X POST "https://capydra.com/api/v1/seller/endpoint/verify-domain" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

GET /api/v1/seller/sandbox

Sandbox certification status of your delivery endpoint (needed before live declared-stock orders).

Auth: seller-scope API key or signed-in seller

curl -s "https://capydra.com/api/v1/seller/sandbox" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/sandbox/certify

Run the sandbox test orders against your delivery endpoint now (at most a few runs per hour).

Auth: seller-scope API key or signed-in seller

curl -s -X POST "https://capydra.com/api/v1/seller/sandbox/certify" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

GET /api/v1/seller/reports

Buyer reports on your orders with reply_until (48 hours after the report), can_reply and can_replace. If you neither answer nor send a replacement by then, the case goes to the shop owner, who decides without you (refund with your fee and a strike, or dismiss).

Auth: seller-scope API key or signed-in seller

curl -s "https://capydra.com/api/v1/seller/reports" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/reports/{id}/replace

Send replacement keys for a key report (exactly one per delivered key, once per order, within 48 hours). The report closes as replaced, the buyer gets a mail and sees the old key marked as replaced.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/reports/rep_xxxxxxxxxxxxxxxx/replace" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"keys":["AAAAA-BBBBB-CCCCC"]}'

GET /api/v1/trust/strikes

Your strikes with the statement of reasons (rule, action, until, automated).

Auth: seller-scope API key or signed-in seller

curl -s "https://capydra.com/api/v1/trust/strikes" -H "Authorization: Bearer $OMK_SELLER_KEY"

GET /api/v1/seller/offers

Your offers: status, stock, your net price, commission and buyer price.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
statusqueryactive, paused, draft or hidden.
curl -s "https://capydra.com/api/v1/seller/offers" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/offers

Create an offer. price_cents is the price you want to receive per unit; the commission is added on top.

Auth: seller-scope API key or signed-in seller

curl -s -X POST "https://capydra.com/api/v1/seller/offers" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"product_id":"prd_hogwarts","price_cents":1500,"fulfilment":"manual"}'

POST /api/v1/seller/offers:batch

Create up to 50 offers in one call. Each item runs the same checks as POST /api/v1/seller/offers and gets its own result (ok, or error and message); one bad item never stops the others. dry_run: true checks everything and writes nothing. Send an Idempotency-Key so a retry does not run twice. holds lists price_review or proof_review when an offer waits for a person. Instead of product_id an item can carry ean, steam_app_id, sku or name plus platform and region (see GET /api/v1/catalog/match): only a sure match (exact or high) lists, otherwise the item fails with no_confident_match and the candidates.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
batch *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/offers:batch" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Idempotency-Key: listing-2026-11-07-001" -H "Content-Type: application/json" -d '{"dry_run":true,"items":[{"ref":"row-1","product_id":"prd_hogwarts","price_cents":1500},{"ref":"row-2","product_id":"prd_forza5","price_cents":1200,"status":"draft"}]}'

POST /api/v1/seller/prices:batch

Change the price of up to 100 of your offers in one call, with a result per item. Same price as now: unchanged, nothing written. dry_run: true shows the new buyer prices and holds and writes nothing.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
batch *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/prices:batch" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Idempotency-Key: prices-2026-11-07-001" -H "Content-Type: application/json" -d '{"dry_run":false,"items":[{"offer_id":"off_xxxxxxxxxxxxxxxx","price_cents":1450}]}'

GET /api/v1/seller/offers/{id}

One of your offers.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/offers/{id}/price

New price you want to receive; commission and buyer price are recomputed.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx/price" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"price_cents":1600}'

POST /api/v1/seller/offers/{id}/stock

Upload keys to a manual offer (encrypted; duplicates across the platform are refused; never echoed).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx/stock" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"keys":["AAAAA-BBBBB-CCCCC","DDDDD-EEEEE-FFFFF"]}'

POST /api/v1/seller/offers/{id}/stock:upload

Big key upload (up to 10,000 keys) as a background job. Answers 202 with the job at once; poll GET /api/v1/seller/jobs/{id} until status is done or failed. Bad lines become per-item errors (index and error, never the key): key_too_long, duplicate_in_upload, already_stored. Keys waiting in a job count toward your daily key limit. At most 3 open jobs. All keys of one job form one key batch (batch_id).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
upload *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx/stock:upload" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Idempotency-Key: stock-2026-11-07-001" -H "Content-Type: application/json" -d '{"keys":["AAAAA-BBBBB-CCCCC","DDDDD-EEEEE-FFFFF"]}'

GET /api/v1/seller/jobs

Your upload jobs, newest first (kept 30 days).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
statusqueryqueued, running, done or failed.
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/seller/jobs" -H "Authorization: Bearer $OMK_SELLER_KEY"

GET /api/v1/seller/jobs/{id}

One upload job: status, counts (received, accepted, processed, added, duplicates, rejected), the first 200 per-item errors, batch_id and the orders delivered from the new keys.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/seller/jobs/job_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer $OMK_SELLER_KEY"

GET /api/v1/seller/orders

Orders of your offers, filtered to the key's kind (sandbox or live).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
statusqueryOnly orders with this status.
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/seller/orders" -H "Authorization: Bearer $OMK_SELLER_KEY"

GET /api/v1/seller/mcp-audit

Every call of an MCP write tool made with your keys (dry runs and errors too), newest first, kept 90 days. Arguments and results are short summaries; product keys are never stored (a key list shows as a count).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/seller/mcp-audit" -H "Authorization: Bearer $OMK_SELLER_KEY"

GET /api/v1/seller/product-requests

Your product requests, newest first.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
statusqueryopen, added or declined.
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/seller/product-requests" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/product-requests

Ask for a product we do not list yet. A person checks it; GET /api/v1/seller/product-requests shows the answer (added with product_id, or declined with a reason). 409 product_exists when a sure match exists. At most 20 open requests.

Auth: seller-scope API key or signed-in seller

curl -s -X POST "https://capydra.com/api/v1/seller/product-requests" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"name":"Example Game Deluxe Edition","platform":"Steam","region":"EU","type":"game","steam_app_id":"123456","ean":"4012345678901","note":"Supplier invoice ready."}'

webhooks

Signed event calls to your server (Standard Webhooks format).

GET /api/v1/seller/webhooks

Your webhook endpoints and the event types you can subscribe to.

Auth: seller-scope API key or signed-in seller

curl -s "https://capydra.com/api/v1/seller/webhooks" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/webhooks

Register an https endpoint (at most 5). Calls are signed in the Standard Webhooks format: headers webhook-id, webhook-timestamp and webhook-signature = "v1," + base64 HMAC-SHA256 over "id.timestamp.body" with the base64 part of the secret (whsec_...). Drop calls older than 5 minutes and ids you have seen. Answer 2xx within 10 seconds; otherwise we retry after 5 min, 30 min, 2 h, 5 h, 10 h and 24 h. The secret is in this answer only. Each event carries the full current state; no buyer data is sent.

Auth: seller-scope API key or signed-in seller

curl -s -X POST "https://capydra.com/api/v1/seller/webhooks" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"url":"https://example.com/omk-webhooks","events":["order.paid","order.refunded","offer.held"],"description":"shop bot"}'

GET /api/v1/seller/webhooks/deliveries

Delivery log, newest first (kept 30 days): status, attempts, last status code or error, next try.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
endpoint_idqueryOnly this endpoint.
statusquerypending, delivered or failed.
event_typequeryOnly this event type.
limitqueryPage size, 1-50 (default 20).
offsetqueryItems to skip.
curl -s "https://capydra.com/api/v1/seller/webhooks/deliveries?status=failed" -H "Authorization: Bearer $OMK_SELLER_KEY"

POST /api/v1/seller/webhooks/deliveries/{id}/retry

Send one event again now, with the same webhook-id.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/deliveries/1/retry" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/seller/webhooks/{id}/test

Send a webhook.test event to this endpoint now and see the result (delivered, status_code, error).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/test" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/seller/webhooks/{id}/rotate-secret

New secret (in this answer only). For overlap_hours (default 24, max 168) every call carries both signatures, so you can switch without missing events.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/rotate-secret" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"overlap_hours":24}'

POST /api/v1/seller/webhooks/{id}/disable

Stop sending to this endpoint. An endpoint that fails 100 tries in a row is disabled by itself.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/disable" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/seller/webhooks/{id}/enable

Send to this endpoint again (the failure count starts at 0).

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/enable" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/seller/webhooks/{id}/delete

Delete the endpoint and its delivery log.

Auth: seller-scope API key or signed-in seller

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/delete" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'

mcp

Model Context Protocol endpoint for AI assistants.

POST /mcp

MCP server (Streamable HTTP, stateless JSON-RPC). Buyer tools for every key; seller tools only for seller-scope keys. Send Accept: application/json, text/event-stream.

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/mcp" -H "Authorization: Bearer $OMK_KEY" -H "Accept: application/json, text/event-stream" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

admin

Admin session only (API keys never carry the admin role).

GET /api/v1/orders/{id}/ledger

The ledger journals of one order (admin).

Auth: admin session (not available to API keys)

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/ledger" -b "omk_session=$OMK_SESSION"

GET /api/v1/house/queue

Paid house-seller orders waiting for a key (admin).

Auth: admin session (not available to API keys)

curl -s "https://capydra.com/api/v1/house/queue" -b "omk_session=$OMK_SESSION"

POST /api/v1/house/orders/{id}/key

The house seller delivers: { key } | { keys: [...] } | { from_stock: true } (admin).

Auth: admin session (not available to API keys)

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/house/orders/ord_xxxxxxxxxxxxxxxx/key" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"from_stock":true}'

GET /api/v1/admin/payouts

Payouts and the balances due (admin).

Auth: admin session (not available to API keys)

ParameterInDescription
seller_idqueryOnly this seller.
statusquerypending, done or failed.
curl -s "https://capydra.com/api/v1/admin/payouts" -b "omk_session=$OMK_SESSION"

POST /api/v1/admin/payouts

Pay one seller now (admin).

Auth: admin session (not available to API keys)

curl -s -X POST "https://capydra.com/api/v1/admin/payouts" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"seller_id":"sel_xxxxxxxxxxxxxxxx"}'

POST /api/v1/admin/sellers/{id}/approve

Approve a seller's onboarding (admin).

Auth: admin session (not available to API keys)

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/admin/sellers/sel_xxxxxxxxxxxxxxxx/approve" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"note":"ID and address checked."}'

POST /api/v1/admin/sellers/{id}/reject

Reject a seller's onboarding with a reason the seller is told (admin).

Auth: admin session (not available to API keys)

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/admin/sellers/sel_xxxxxxxxxxxxxxxx/reject" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"reason":"The ID document is not readable."}'

other

Routes of other modules without their own documentation entry.

GET /api/v1/keys/usage

GET /api/v1/keys/usage (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/keys/usage" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/catalog/products

GET /api/v1/catalog/products (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/catalog/products" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/catalog/products/{id}

GET /api/v1/catalog/products/:id (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/catalog/products/<id>" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/purchase/balance

GET /api/v1/purchase/balance (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/purchase/balance" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/purchase/orders

GET /api/v1/purchase/orders (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/purchase/orders" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/purchase/orders

POST /api/v1/purchase/orders (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/api/v1/purchase/orders" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

GET /api/v1/purchase/orders/{id}

GET /api/v1/purchase/orders/:id (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s "https://capydra.com/api/v1/purchase/orders/<id>" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/purchase/orders/{id}/keys

POST /api/v1/purchase/orders/:id/keys (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/purchase/orders/<id>/keys" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

GET /api/v1/seller/reservations

GET /api/v1/seller/reservations (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/seller/reservations" -H "Authorization: Bearer $OMK_KEY"

GET /api/v1/webhooks

GET /api/v1/webhooks (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/webhooks" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/webhooks

POST /api/v1/webhooks (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s -X POST "https://capydra.com/api/v1/webhooks" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

GET /api/v1/webhooks/deliveries

GET /api/v1/webhooks/deliveries (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

curl -s "https://capydra.com/api/v1/webhooks/deliveries" -H "Authorization: Bearer $OMK_KEY"

POST /api/v1/webhooks/deliveries/{id}/retry

POST /api/v1/webhooks/deliveries/:id/retry (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/webhooks/deliveries/<id>/retry" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/webhooks/{id}/test

POST /api/v1/webhooks/:id/test (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/test" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/webhooks/{id}/rotate-secret

POST /api/v1/webhooks/:id/rotate-secret (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/rotate-secret" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/webhooks/{id}/disable

POST /api/v1/webhooks/:id/disable (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/disable" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/webhooks/{id}/enable

POST /api/v1/webhooks/:id/enable (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/enable" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'

POST /api/v1/webhooks/{id}/delete

POST /api/v1/webhooks/:id/delete (added by another module; no description yet).

Auth: API key (Bearer) or signed-in session

ParameterInDescription
id *pathstring
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/delete" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'