Wallets

Claim non-custodial control for a customer

Initiates a multi-signer non-custodial provisioning flow. Returns 202 with a claimId; per-signer verification URLs are delivered via wallet_signer.invited webhooks.

A business customer’s roster has exactly 2 admins (400 ROSTER_BELOW_MIN_ADMINS with fewer, 400 ROSTER_ABOVE_MAX_ADMINS with more); every other member is a signer. An individual customer’s roster has exactly one admin and at most one person. The person is the member under the individual’s email on file, with credentialType: "passkey", and must be the admin; every other member is an api_key member with role: "signer". With no person, which only programmatic unattended allows, the admin is one api_key member. Any other roster returns 422 INDIVIDUAL_ROSTER_INVALID, and so does a later add of a passkey member or an admin, or a promote to admin. Unlike a business, an individual’s roster cannot have the person and an api_key admin together. The person enrolls two passkeys (for example on two devices) before the wallet activates, so one lost device does not lose the funds. Conduit can never sign or change the wallet alone.

Valid roster shapes depend on the customer’s signing mode, which Conduit sets per organization (with an optional per-customer override) — confirm the customer’s configured mode before building the roster: passkey required — any api_key member returns 422 SIGNING_MODE_ROSTER_INVALID; programmatic — api_key members must have role: "signer" (an api_key admin returns 422 SIGNING_MODE_ROSTER_INVALID); programmatic unattended — api_key admins are allowed. In every mode the active signers of any credential type must be able to reach signingThreshold; passkeys count toward it. Each api_key member carries a publicKey — the compressed public key, 33 bytes / 66 hex chars, 02/03 prefix, on the curve of its signatureScheme (p256 by default, or secp256k1 / secp256k1_eip191) — and is active at claim — an all-machine roster activates the wallets without an enrollment phase; mixed rosters wait on every passkey enrollment. Omitting chains provisions the default set: base, ethereum, polygon, tron. A default chain that does not settle in the environment is left out. A chain whose addresses need a one-time on-chain setup is not in the default set: name it in chains. Its wallet reads pending until the signers approve that setup, announced by wallet.awaiting_setup_signature. See Programmatic payout signing and Add a crypto wallet.

POST

customers

{customerId}

wallets

claim-non-custodial

Claim non-custodial control for a customer

curl --request POST \
  --url https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "roster": [
    {
      "email": "jsmith@example.com",
      "name": "<string>",
      "publicKey": "02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
    }
  ],
  "signingThreshold": 4503599627370496,
  "chains": []
}
'

import requests

url = "https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial"

payload = {
    "roster": [
        {
            "email": "jsmith@example.com",
            "name": "<string>",
            "publicKey": "02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
        }
    ],
    "signingThreshold": 4503599627370496,
    "chains": []
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    roster: [
      {
        email: 'jsmith@example.com',
        name: '<string>',
        publicKey: '02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2'
      }
    ],
    signingThreshold: 4503599627370496,
    chains: []
  })
};

fetch('https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'roster' => [
        [
                'email' => 'jsmith@example.com',
                'name' => '<string>',
                'publicKey' => '02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2'
        ]
    ],
    'signingThreshold' => 4503599627370496,
    'chains' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial"

	payload := strings.NewReader("{\n  \"roster\": [\n    {\n      \"email\": \"jsmith@example.com\",\n      \"name\": \"<string>\",\n      \"publicKey\": \"02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\"\n    }\n  ],\n  \"signingThreshold\": 4503599627370496,\n  \"chains\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"roster\": [\n    {\n      \"email\": \"jsmith@example.com\",\n      \"name\": \"<string>\",\n      \"publicKey\": \"02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\"\n    }\n  ],\n  \"signingThreshold\": 4503599627370496,\n  \"chains\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"roster\": [\n    {\n      \"email\": \"jsmith@example.com\",\n      \"name\": \"<string>\",\n      \"publicKey\": \"02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\"\n    }\n  ],\n  \"signingThreshold\": 4503599627370496,\n  \"chains\": []\n}"

response = http.request(request)
puts response.read_body

{
  "claimId": "<string>",
  "customerId": "<string>",
  "status": "provisioning",
  "rosterSize": 4503599627370495,
  "signingThreshold": 4503599627370495,
  "estimatedActivationCompletionMinutes": 0
}

{
  "type": "INVALID_OID_FORMAT",
  "title": "Invalid Object ID Format",
  "status": 400,
  "detail": "A path or query parameter expected a valid object identifier but received a value that does not match the expected format.",
  "resolution": "Verify that all IDs in the request URL and query parameters are correctly formatted. IDs are typically prefixed strings like 'cus_...', 'app_...', or 'doc_...'.",
  "docs": "https://conduit-v2.mintlify.app/errors#invalid-oid-format",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "API_KEY_MISSING",
  "title": "API Key Missing",
  "status": 401,
  "detail": "The request did not include an API key. All API requests must be authenticated.",
  "resolution": "Include your API key in the 'x-api-key' header with every request.",
  "docs": "https://conduit-v2.mintlify.app/errors#api-key-missing",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "ORGANIZATION_ACCESS_SUSPENDED",
  "title": "Organization Access Suspended",
  "status": 403,
  "detail": "Conduit has suspended this organization's access. Requests with the organization's API keys and from its users are refused until Conduit restores access.",
  "resolution": "Contact Conduit support.",
  "docs": "https://conduit-v2.mintlify.app/errors#organization-access-suspended",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "CUSTOMER_NOT_FOUND",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "No customer exists with the specified ID, or the customer belongs to a different organization.",
  "resolution": "Verify the customer ID is correct. Use the list customers endpoint to find valid customer IDs for your organization.",
  "docs": "https://conduit-v2.mintlify.app/errors#customer-not-found",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "IDEMPOTENCY_KEY_CONFLICT",
  "title": "Idempotency Key Conflict",
  "status": 409,
  "detail": "The idempotency key was previously used with a different request body, and that request succeeded or ended in a `5xx`. A `4xx` response does not bind the key. Idempotency keys are bound to the exact request shape — replays must match the original.",
  "resolution": "Use a fresh idempotency key for the new request, or replay the original request unchanged.",
  "docs": "https://conduit-v2.mintlify.app/errors#idempotency-key-conflict",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "UNSUPPORTED_MEDIA_TYPE",
  "title": "Unsupported Media Type",
  "status": 415,
  "detail": "The request carries a body with a Content-Type this endpoint cannot parse. JSON endpoints accept 'application/json'; a body with no Content-Type header at all is assumed to be JSON. File-upload endpoints accept only 'multipart/form-data' — JSON or undeclared bodies are rejected there.",
  "resolution": "Send the request body with the 'Content-Type: application/json' header. For file uploads, use 'Content-Type: multipart/form-data' — upload endpoints accept no other body type.",
  "docs": "https://conduit-v2.mintlify.app/errors#unsupported-media-type",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "CUSTOMER_KYB_INCOMPLETE",
  "title": "Customer KYB Incomplete",
  "status": 422,
  "detail": "Non-custodial control can only be claimed after the customer's KYB application has been approved.",
  "resolution": "Complete and submit the customer's KYB application, wait for approval, and retry the claim once the customer is active.",
  "docs": "https://conduit-v2.mintlify.app/errors#customer-kyb-incomplete",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "RATE_LIMITED",
  "title": "Rate Limited",
  "status": 429,
  "detail": "Too many requests. This error is returned by three independent checks: the per-organization bucket applied to every authenticated API request; the per-IP bucket applied to unauthenticated traffic before an API key is validated; and the per-IP bucket applied when repeated invalid API keys are submitted from the same address. Honor the Retry-After header (also exposed as retryAfterSeconds in the body) before retrying. Current limits and remaining budget are visible in X-RateLimit-Limit (the bucket size), X-RateLimit-Remaining, and X-RateLimit-Reset (seconds until the bucket refills) on every response once your API key is accepted.",
  "resolution": "Sleep until Retry-After seconds have elapsed, then retry. For sustained workloads exceeding the per-organization defaults, request a rate-limit increase through your support contact.",
  "docs": "https://conduit-v2.mintlify.app/errors#rate-limited",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z",
  "retryAfterSeconds": 3
}

{
  "type": "INTERNAL_ERROR",
  "title": "Internal Error",
  "status": 500,
  "detail": "An unexpected error occurred while processing your request.",
  "resolution": "Retry the request after a brief delay. If the error persists, contact support and include the correlationId from the error response for investigation.",
  "docs": "https://conduit-v2.mintlify.app/errors#internal-error",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "ASSET_CHAIN_PAUSED",
  "title": "Asset Chain Paused",
  "status": 503,
  "detail": "Conduit has temporarily paused this asset on this chain, or the whole chain, so it cannot accept this request now. Asset and chain pairs that are not paused stay available.",
  "resolution": "Retry the same request later; it succeeds once Conduit lifts the pause. Use an asset and chain pair that is not paused if you cannot wait.",
  "docs": "https://conduit-v2.mintlify.app/errors#asset-chain-paused",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

Authorizations

x-api-key

string

header

required

Headers

Idempotency-Key

string

required

Caller-generated unique key that lets the server safely replay this request. The original response is returned for 30 days on any retry with the same key from the same organization, with the response header Idempotency-Replayed: true. Required on every state-changing money-moving or resource-creating POST.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9_.:-]{1,128}$

Example:

"01J7B3K2X9M8N5P6Q7R8S9T0V1"

Path Parameters

customerId

string

required

Example:

"cus_1A2b3C4d5E6f7G8h9I0jKl"

Body

application/json

roster

object[]

required

Everyone who will be able to approve on this wallet. Each member activates their own signer afterwards. A business customer's roster has exactly 2 admins. An individual customer's roster has exactly one admin and at most one person: the person is the member under the individual's email on file, with credentialType: passkey, is the admin, and enrolls two passkeys before the wallet activates; every other member is an api_key signer. Under programmatic unattended the roster can instead be one api_key admin and api_key signers.

Required array length: 1 - 100 elements

Show child attributes

signingThreshold

integer

required

How many roster members must approve before a transaction is signed. At least 1, and never more than the roster size.

Required range: 1 <= x <= 9007199254740991

chains

enum<string>[]

Optional. Chains to provision (each must be a supported chain). Omit to auto-provision each default chain that settles in this environment (recommended) so later chain use needs no re-authentication. Accepting a chain here does not imply Conduit operationally supports asset movement on it yet.

Required array length: 1 - 100 elements

Available options:

ethereum,

base,

solana,

polygon,

tron,

stellar,

tempo,

arbitrum

Response

claimId

string

required

Id of this claim, carried by the webhooks that report its progress. Each id has the form wcc_ followed by 22 alphanumeric characters.

Pattern: ^wcc_[0-9A-Za-z]{22}$

customerId

string

required

Customer the wallets are provisioned for. Each id has the form cus_ followed by 22 alphanumeric characters.

Pattern: ^cus_[0-9A-Za-z]{22}$

status

enum<string>

required

Always provisioning: the claim was accepted and the wallets are being set up in the background. Wait for the wallet_signer.* and crypto_wallet.completed webhooks.

Available options:

provisioning

rosterSize

integer

required

How many signers the claim put on the roster.

Required range: 0 <= x <= 9007199254740991

signingThreshold

integer

required

How many signer stamps each payout needs to proceed. Separate from activation, which waits for every roster member to enroll.

Required range: 0 < x <= 9007199254740991

estimatedActivationCompletionMinutes

integer

required

Advisory estimate of minutes to full activation (not an SLA).

Required range: -9007199254740991 <= x <= 9007199254740991

⌘I

Claim non-custodial control for a customer

curl --request POST \
  --url https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "roster": [
    {
      "email": "jsmith@example.com",
      "name": "<string>",
      "publicKey": "02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
    }
  ],
  "signingThreshold": 4503599627370496,
  "chains": []
}
'

import requests

url = "https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial"

payload = {
    "roster": [
        {
            "email": "jsmith@example.com",
            "name": "<string>",
            "publicKey": "02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
        }
    ],
    "signingThreshold": 4503599627370496,
    "chains": []
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    roster: [
      {
        email: 'jsmith@example.com',
        name: '<string>',
        publicKey: '02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2'
      }
    ],
    signingThreshold: 4503599627370496,
    chains: []
  })
};

fetch('https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'roster' => [
        [
                'email' => 'jsmith@example.com',
                'name' => '<string>',
                'publicKey' => '02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2'
        ]
    ],
    'signingThreshold' => 4503599627370496,
    'chains' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial"

	payload := strings.NewReader("{\n  \"roster\": [\n    {\n      \"email\": \"jsmith@example.com\",\n      \"name\": \"<string>\",\n      \"publicKey\": \"02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\"\n    }\n  ],\n  \"signingThreshold\": 4503599627370496,\n  \"chains\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"roster\": [\n    {\n      \"email\": \"jsmith@example.com\",\n      \"name\": \"<string>\",\n      \"publicKey\": \"02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\"\n    }\n  ],\n  \"signingThreshold\": 4503599627370496,\n  \"chains\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.conduit.financial/v2/customers/{customerId}/wallets/claim-non-custodial")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"roster\": [\n    {\n      \"email\": \"jsmith@example.com\",\n      \"name\": \"<string>\",\n      \"publicKey\": \"02a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\"\n    }\n  ],\n  \"signingThreshold\": 4503599627370496,\n  \"chains\": []\n}"

response = http.request(request)
puts response.read_body

{
  "claimId": "<string>",
  "customerId": "<string>",
  "status": "provisioning",
  "rosterSize": 4503599627370495,
  "signingThreshold": 4503599627370495,
  "estimatedActivationCompletionMinutes": 0
}

{
  "type": "INVALID_OID_FORMAT",
  "title": "Invalid Object ID Format",
  "status": 400,
  "detail": "A path or query parameter expected a valid object identifier but received a value that does not match the expected format.",
  "resolution": "Verify that all IDs in the request URL and query parameters are correctly formatted. IDs are typically prefixed strings like 'cus_...', 'app_...', or 'doc_...'.",
  "docs": "https://conduit-v2.mintlify.app/errors#invalid-oid-format",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "API_KEY_MISSING",
  "title": "API Key Missing",
  "status": 401,
  "detail": "The request did not include an API key. All API requests must be authenticated.",
  "resolution": "Include your API key in the 'x-api-key' header with every request.",
  "docs": "https://conduit-v2.mintlify.app/errors#api-key-missing",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "ORGANIZATION_ACCESS_SUSPENDED",
  "title": "Organization Access Suspended",
  "status": 403,
  "detail": "Conduit has suspended this organization's access. Requests with the organization's API keys and from its users are refused until Conduit restores access.",
  "resolution": "Contact Conduit support.",
  "docs": "https://conduit-v2.mintlify.app/errors#organization-access-suspended",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "CUSTOMER_NOT_FOUND",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "No customer exists with the specified ID, or the customer belongs to a different organization.",
  "resolution": "Verify the customer ID is correct. Use the list customers endpoint to find valid customer IDs for your organization.",
  "docs": "https://conduit-v2.mintlify.app/errors#customer-not-found",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "IDEMPOTENCY_KEY_CONFLICT",
  "title": "Idempotency Key Conflict",
  "status": 409,
  "detail": "The idempotency key was previously used with a different request body, and that request succeeded or ended in a `5xx`. A `4xx` response does not bind the key. Idempotency keys are bound to the exact request shape — replays must match the original.",
  "resolution": "Use a fresh idempotency key for the new request, or replay the original request unchanged.",
  "docs": "https://conduit-v2.mintlify.app/errors#idempotency-key-conflict",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "UNSUPPORTED_MEDIA_TYPE",
  "title": "Unsupported Media Type",
  "status": 415,
  "detail": "The request carries a body with a Content-Type this endpoint cannot parse. JSON endpoints accept 'application/json'; a body with no Content-Type header at all is assumed to be JSON. File-upload endpoints accept only 'multipart/form-data' — JSON or undeclared bodies are rejected there.",
  "resolution": "Send the request body with the 'Content-Type: application/json' header. For file uploads, use 'Content-Type: multipart/form-data' — upload endpoints accept no other body type.",
  "docs": "https://conduit-v2.mintlify.app/errors#unsupported-media-type",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "CUSTOMER_KYB_INCOMPLETE",
  "title": "Customer KYB Incomplete",
  "status": 422,
  "detail": "Non-custodial control can only be claimed after the customer's KYB application has been approved.",
  "resolution": "Complete and submit the customer's KYB application, wait for approval, and retry the claim once the customer is active.",
  "docs": "https://conduit-v2.mintlify.app/errors#customer-kyb-incomplete",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "RATE_LIMITED",
  "title": "Rate Limited",
  "status": 429,
  "detail": "Too many requests. This error is returned by three independent checks: the per-organization bucket applied to every authenticated API request; the per-IP bucket applied to unauthenticated traffic before an API key is validated; and the per-IP bucket applied when repeated invalid API keys are submitted from the same address. Honor the Retry-After header (also exposed as retryAfterSeconds in the body) before retrying. Current limits and remaining budget are visible in X-RateLimit-Limit (the bucket size), X-RateLimit-Remaining, and X-RateLimit-Reset (seconds until the bucket refills) on every response once your API key is accepted.",
  "resolution": "Sleep until Retry-After seconds have elapsed, then retry. For sustained workloads exceeding the per-organization defaults, request a rate-limit increase through your support contact.",
  "docs": "https://conduit-v2.mintlify.app/errors#rate-limited",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z",
  "retryAfterSeconds": 3
}

{
  "type": "INTERNAL_ERROR",
  "title": "Internal Error",
  "status": 500,
  "detail": "An unexpected error occurred while processing your request.",
  "resolution": "Retry the request after a brief delay. If the error persists, contact support and include the correlationId from the error response for investigation.",
  "docs": "https://conduit-v2.mintlify.app/errors#internal-error",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

{
  "type": "ASSET_CHAIN_PAUSED",
  "title": "Asset Chain Paused",
  "status": 503,
  "detail": "Conduit has temporarily paused this asset on this chain, or the whole chain, so it cannot accept this request now. Asset and chain pairs that are not paused stay available.",
  "resolution": "Retry the same request later; it succeeds once Conduit lifts the pause. Use an asset and chain pair that is not paused if you cannot wait.",
  "docs": "https://conduit-v2.mintlify.app/errors#asset-chain-paused",
  "instance": "/v2/...",
  "correlationId": "00469ea4-52c1-4ffa-bd05-9f28b236a5fe",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

Overview

Errors

Customers

Registered Addresses

Wallets

Wallet Signers

Signing Quorum

Virtual Accounts

Applications

Verifications

Signing Requests

Transactions

Payouts

RFIs

Documents

Whitelist Recipients

Orders

Asset Chain Pairs

Quotes

Webhook Endpoints

Webhook Deliveries

Webhook Event Types

Features

Customer Onboarding

Markup

Sandbox

Claim non-custodial control for a customer

Authorizations

Headers

Path Parameters

Body

Response