Accredd API Reference

Introduction

Authentication

API Keys

Option 1: Embedded UI API

Option 2: Traditional API

api.accredd.com

Introduction

The Accredd API is RESTful and very easy to integrate. You can try out the API without writing a single line of code at api.accredd.com. Please message us at sales@accredd.com for a test API key if you are evaluating an integration with us.

There are two implementation options to the Accredd API: Embedded UI and Traditional. We recommend you start with the Embedded UI API because it is the fastest to market (hours instead of days or weeks), and you can always switch to the Traditional API at a later time.

 

Authentication

The Accredd API uses API keys to authenticate requests. You can view and manage your API keys in the Accredd Dashboard.

Your API keys carry many privileges, so please make sure to keep them secured by not sharing your secret API keys in public spaces such as shared docs, GitHub, client-side code, etc.

The API key has two modes: Development and Production. You can easily switch between the modes within the Accredd Dashboard.

API Keys

Accredd authenticates your API requests using your account’s API keys. Accredd will return an invalid request error if your request doesn’t include a valid API key.

Accredd makes revoking or managing an API key very simple. You can create a Development key, a Production key, or change access permissions all with a click of a button.

You can use the Accredd Dashboard to generate and control the API keys between Development mode and Production mode.

Development mode versus production mode

All Accredd API requests happen in either Development mode or Production mode. Use the former to test and access dummy data, in addition to manipulating the status of a submission so you can handle the various scenarios. Switch from Development mode to Production mode when you’re ready to deploy the API in a live environment.

Sandbox Key

Please message us at sales@accredd.com for a test API key if you are evaluating an integration with us.

Option 1: Embedded UI API

The Embedded UI API model is useful if you want the fastest time to market and are not interested in building or maintaining an investor verification UI.  The out-of-the-box embedded UI is highly flexible and shipped with many configurable options which you can hide or show based on what information you want the user to see in your application.

  • Obtain an API Key from your dashboard.
  • Call the embed-ui-link to get back an embeddable link.
  • Use the embeddable link in your application.
  • Get the status on a verification submission.  If you are in Development mode, you can set and get different verification statuses to complete your integration.  
  • Seamlessly switch from Development mode to Production mode with the same API Key controls which mode you are in.
  • Optionally, download a verification letter. If you are not interested in storing or managing a verification letter, you can skip this step.

Option 2: Traditional API

This API model is useful if you want to completely build out your own investor verification UI experience.  We recommend you start with the Embedded UI API model first unless you already have a verification UI or have some special requirements which you find the Embedded UI lacking.  Contact us if you need to talk to one of our experts about choosing an integration model.

  • Generate Obtain an API Key from your dashboard.
  • Submit a new verification.
  • Get the status on a verification submission.  If you are in Development mode, you can set and get different verification statuses to complete your integration.  The API Key controls which mode you are in.
  • Optionally download a verification letter.  If you are not interested in storing or managing a verification letter, you can skip this step.