Getting Started

Learn how to set up your account, API credentials, and make your first call.

Sandbox Account & API Keys

Go here to start gaining access to Sandbox API Keys and to make authenticated calls.

API Authentication

Conduit uses custom HTTP headers to authenticate requests. Each header contains one part of your API credentials.

X-API-Key: The Key Identifier you received during onboarding

X-API-Secret: The Key Secret you received during onboarding

Make Your First API Call

Let's use your API credentials to make your first call. You can use Postman or cURL to get a feel for our APIs before writing any code.

Content-type Required

The Conduit API will reject all request bodies that do not have a Content-type header specifying media type application/vnd.api+json or application/json.

When your API credentials are issued, we automatically register a single account holder (user) and create a corresponding account. So for our first call, let's query for a list of account holders.

Postman

1. Download this Postman Collection to help get you started and import it into Postman.

Postman Import

2. Create a new environment called Conduit Sandbox with your API Key and API Key Secret as shown below and make sure to switch to that environment on the top right.

Postman Import

3. In the "Collection" tab, find the GET request List Account Holders and click "Send".

Postman Import

4. If successful, you will see a similar response from the API.

Postman Import

cURL

1. Run the following query:

Copy
Copied
curl \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  https://sandbox.conduit.financial/account-holders

2. If successful, you will see a similar response from the API with your entity's name as firstName:

Copy
Copied
{
  "data": [
    {
      "id": "id:ahl:2IEoxG0HmxpbpfsYs9WXjAbI3Gh",
      "type": "account-holder",
      "attributes": {
        "externalId": null,
        "firstName": "Conduit",
        "lastName": "Financial",
        "verificationStatus": "pending"
      },
      "relationships": {
        "accounts": {
          "links": {
            "next": null,
            "self": "/account-holders/id:ahl:2IEoxG0HmxpbpfsYs9WXjAbI3Gh/relationships/accounts",
            "related": "/account-holders/id:ahl:2IEoxG0HmxpbpfsYs9WXjAbI3Gh/accounts"
          },
          "data": [
            {
              "id": "id:acct:2IEp9oFQwLpSBH5UsNA9Vh1EezH",
              "type": "account"
            }
          ]
        }
      }
    }

Next Steps

Now that you’re successfully making authenticated requests to the API with your API key, you’re ready to dive into the Conduit API.

The first thing you may want to do is learn how to register your first user using the API or browse our other guides.