API docs by Redocly

Amiqus ID REST API (2.0)

Download OpenAPI specification:Download

Amiqus Engineering: developers@amiqus.co URL: https://developers.amiqus.co/aqid/api-reference.html

Amiqus ID API reference.

🚧 Please note this documentation is beta and is subject to change without notice.

Changelog

Service Status

Check service status

The status endpoint can be used to perform an authenticated request to verify the access token is valid and that the service is operational.

Authorizations:
personal_tokenoauth

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/status \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

User Account

Retrieve user account

Retrieve details of the current user's account.

Access tokens are scoped to a single user account and team (if they are a member of more than one). This endpoint can be used to determine which user the access token was issued for.

To retrieve details of the user's role within their current team, refer to Retrieve team membership.

Authorizations:
personal_tokenoauth

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/me \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "user",
  • "id": 345789,
  • "name": "Bob Gale",
  • "email": "bob@example.com",
  • "is_verified": true,
  • "is_disabled": false,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z"
}

Update user account

Update the current user's account details.

When updating a user's email address, the change must be confirmed by the user via an email sent to their current email address. The updated email address won't be reflected in the response until the confirmation is complete.

It is not possible to update a user's password using the API.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
non-empty
name
string

Full or partial name

The value is not formatted (e.g. title case), and appears as written.

email
string <email>

Unique user email address

Responses

Request samples

Content type
application/json
{
  • "name": "Robert Gale"
}

Response samples

Content type
application/json
{
  • "object": "user",
  • "id": 345789,
  • "name": "Robert Gale",
  • "email": "bob@example.com",
  • "is_verified": true,
  • "is_disabled": false,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z"
}

List all my teams

List all teams the current user is a member of.

A user can be a member of multiple teams. To retrieve details of the team the access token is scoped to, refer to Retrieve current team.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/me/teams?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Your Team

Retrieve current team

Returns basic details of the current team.

Authorizations:
personal_tokenoauth

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/team \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "team",
  • "id": 88,
  • "identifier": "fusion-industries",
  • "uuid": "6b9c8323-4b54-4bb3-a1c8-68de534368a5",
  • "name": "Fusion Industries",
  • "contact": "fusion.support@example.com",
  • "telephone": null,
  • "tier": "standard_2021",
  • "logo": null,
  • "is_support_enabled": true,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "archived_at": null
}

Update current team

Updates basic details of the current team.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
non-empty
contact
string <email>
telephone
null or string

Responses

Request samples

Content type
application/json
{
  • "contact": "fusion@example.com"
}

Response samples

Content type
application/json
{
  • "object": "team",
  • "id": 88,
  • "identifier": "fusion-industries",
  • "uuid": "6b9c8323-4b54-4bb3-a1c8-68de534368a5",
  • "name": "Fusion Industries",
  • "contact": "fusion@example.com",
  • "telephone": null,
  • "tier": "standard_2021",
  • "logo": null,
  • "is_support_enabled": true,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "archived_at": null
}

Retrieve team membership

Retrieve membership details for the user's current team.

To retrieve the user's basic details, refer to Retrieve user account.

Authorizations:
personal_tokenoauth

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/team/me \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "team_member",
  • "id": 121,
  • "name": "Lorraine Baines",
  • "email": "lorraine@example.com",
  • "role": "owner"
}

List all team members

List all team members of the current team.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/team/members?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Records

List all records

List all records.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
expand
Array of strings
Items Value: "client"
status
string
Enum: "pending" "started" "complete" "incomplete" "waiting" "failed" "empty" "paused" "amendments" "reviewed"

Filter records by their current status

creator
integer

Filter records created by team member user ID

assignee
integer

Filter records assigned to team member user ID

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/records?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&expand=SOME_ARRAY_VALUE&status=SOME_STRING_VALUE&creator=SOME_INTEGER_VALUE&assignee=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Create a record

Create a record.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
One of
client
required
integer

Unique client identifier.

required
Array of (Credit report (TransUnion (object) or Equifax (object))) or Criminal record (object) or Dummy (object) or Thorntons Onboarding (object) or HSCNI Access NI (object) or (Identity report (TransUnion (object) or Equifax (object))) or NHS ESR (object) or Photo ID (object) or Employment history (object) or Banking information (object) or Face capture (object) or Watchlist (object) or Document Request (object) or Document Transfer (object) or Form (object) (Record Steps) non-empty

Steps to be completed by the client.

required
string or boolean

Enable or disable a "New Request" notification to the client.

message
null or string <= 5000 characters

Include a message for client.

Message is shown to the client before they begin the first step. It is also included in an email notification, if sent.

reminder
boolean
Default: false

Enable or disable email reminders.

When enabled, the client is sent a reminder email every 2 days until all steps have been completed, the record expires or is archived.

Responses

Request samples

Content type
application/json
Example

A request with a single step containing a Photo ID check

{
  • "client": 7832,
  • "steps": [
    ],
  • "notification": "email"
}

Response samples

Content type
application/json
{
  • "object": "record",
  • "id": 983434,
  • "status": "pending",
  • "perform_url": "https://id.amiqus.co/i/0vz32B9CZpO1yLsKPdy9q",
  • "email": "marty@example.com",
  • "steps": [
    ],
  • "client": 73845,
  • "created_at": "2022-05-22T08:22:12Z",
  • "updated_at": "2022-05-22T08:22:12Z",
  • "archived_at": null
}

Retrieve a record

Retrieve a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

query Parameters
expand
Array of strings
Items Value: "client"

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/records/%7Bid%7D?expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "record",
  • "id": 983434,
  • "status": "pending",
  • "perform_url": "https://id.amiqus.co/i/0vz32B9CZpO1yLsKPdy9q",
  • "email": "marty@example.com",
  • "steps": [
    ],
  • "client": 73845,
  • "created_at": "2022-05-22T08:22:12Z",
  • "updated_at": "2022-05-22T08:22:12Z",
  • "archived_at": null
}

Update a record

Update the details of a record.

To mark a record as expired, refer to Expire a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

Request Body schema: application/json
non-empty
is_archived
boolean

Allows toggling of archived state

is_reviewed
boolean

Allows toggling of reviewed state

Responses

Request samples

Content type
application/json
{
  • "is_archived": true
}

Response samples

Content type
application/json
{
  • "object": "record",
  • "id": 983434,
  • "status": "pending",
  • "perform_url": "https://id.amiqus.co/i/0vz32B9CZpO1yLsKPdy9q",
  • "email": "marty@example.com",
  • "steps": [
    ],
  • "client": 73845,
  • "created_at": "2022-05-22T08:22:12Z",
  • "updated_at": "2022-05-22T08:22:12Z",
  • "archived_at": "2023-09-15T13:03:11Z"
}

Archive a record Deprecated

Archive a record.

This operation is deprecated and will be removed in future versions. To archive a record, please refer to Update a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
query Parameters
expand
Array of strings
Items Value: "client"

Responses

Request samples 

curl --request POST \
  --url 'https://id.amiqus.co/api/v2/records/%7Bid%7D/archive?expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "record",
  • "id": 0,
  • "status": "pending",
  • "perform_url": "string",
  • "email": "user@example.com",
  • "client": {
    },
  • "steps": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "archived_at": null
}

Expire a record

Expire a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

query Parameters
expand
Array of strings
Items Value: "client"

Responses

Request samples 

curl --request POST \
  --url 'https://id.amiqus.co/api/v2/records/%7Bid%7D/expire?expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "record",
  • "id": 0,
  • "status": "pending",
  • "perform_url": "string",
  • "email": "user@example.com",
  • "client": {
    },
  • "steps": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "archived_at": null
}

Download a record

Download a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/records/%7Bid%7D/download \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

List all steps for a record

List all steps for a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
expand
Array of strings
Items Enum: "check" "form" "document"
Examples:
  • expand=check - Expand one step type
  • expand=check,form - Expand multiple step types

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/records/%7Bid%7D/steps?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 3,
  • "count": 3,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

List all documents for a record

List all documents for a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
expand
Array of strings
Items Value: "attachments"

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/records/%7Bid%7D/documents?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
Example

A sent document requested to be returned, with it's completed returned document.

{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Record Assignees

List all assignees for a record

List all assignees for a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/records/%7Bid%7D/assignees?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Set assignees for a record

Set the assignees for a record according to the exact values provided in the request, overwriting any existing assignees. To add additional assignees, refer to Update assignees for a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

Request Body schema: application/json
Array (non-empty)
type
required
string
Value: "user"

The type of assignee to be assigned to the record.

user
required
integer

The unique identifier of the user to be assigned to the record.

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Update assignees for a record

Add one or more assignees to a record, merging them with existing assignees.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

Request Body schema: application/json
Array (non-empty)
Any of
type
required
string
Value: "user"

The type of assignee to be assigned to the record.

user
required
integer

The unique identifier of the user to be assigned to the record.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 3,
  • "count": 3,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Delete assignees for a record

Remove all assignees from a record.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique record identifier.

Request Body schema: application/json
Schema not provided

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/records/%7Bid%7D/assignees \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

Delete assignee for a record

Remove a single assignee from a record.

To list all of a record's assignees, see List all assignees for a record.

Authorizations:
personal_tokenoauth
path Parameters
recordId
required
integer

Unique record identifier.

assigneeId
required
integer

Unique assignee identifier.

Request Body schema: application/json
Schema not provided

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/records/%7BrecordId%7D/assignees/%7BassigneeId%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

Clients

List all clients

Returns a paginated list of clients.

To retrieve a client, refer to Retrieve a client.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/clients?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 3,
  • "count": 3,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Create a client

Create a new client.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
status
string
Enum: "pending" "approved" "rejected"

A status can be set to signify a decision has been made by a team member on the outcome of the client's checks.

required
object (Name)

The client's names.

Includes automatic compilations of the client's full name for display purposes.

email
required
string <email>

Client's contact email address.

landline
null or string

Client's landline telephone number.

mobile
null or string

Client's mobile telephone number.

dob
null or string <date>

Client's date of birth.

reference
null or string

An external reference or identifier to cross-reference with your system.

Responses

Request samples

Content type
application/json
{
  • "name": {
    },
  • "email": "marty@example.com"
}

Response samples

Content type
application/json
{
  • "object": "client",
  • "id": 73845,
  • "status": "pending",
  • "name": {
    },
  • "email": "marty@example.com",
  • "landline": null,
  • "mobile": null,
  • "dob": null,
  • "reference": null,
  • "is_deletable": true,
  • "created_at": "2022-05-21T14:15:22Z",
  • "updated_at": "2022-05-21T14:15:22Z",
  • "archived_at": null
}

Retrieve a client

Returns a single client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "client",
  • "id": 73845,
  • "status": "pending",
  • "name": {
    },
  • "email": "marty@example.com",
  • "landline": null,
  • "mobile": null,
  • "dob": null,
  • "reference": null,
  • "is_deletable": true,
  • "created_at": "2022-05-21T14:15:22Z",
  • "updated_at": "2022-05-21T14:15:22Z",
  • "archived_at": null
}

Update a client

Update the details of a client.

To add or update a client's address, refer to Replace an address for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

Request Body schema: application/json
non-empty
status
string
Enum: "pending" "approved" "rejected"

A status can be set to signify a decision has been made by a team member on the outcome of the client's checks.

object (Name)

The client's names.

Includes automatic compilations of the client's full name for display purposes.

email
string <email>

Client's contact email address.

landline
null or string

Client's landline telephone number.

mobile
null or string

Client's mobile telephone number.

dob
null or string <date>

Client's date of birth.

reference
null or string

An external reference or identifier to cross-reference with your system.

Responses

Request samples

Content type
application/json

Update the client's email address.

{
  • "email": "martin.mcfly@example.com"
}

Response samples

Content type
application/json
{
  • "object": "client",
  • "id": 73845,
  • "status": null,
  • "name": {
    },
  • "email": "martin.mcfly@example.com",
  • "landline": null,
  • "mobile": null,
  • "dob": null,
  • "reference": null,
  • "is_deletable": true,
  • "created_at": "2022-05-21T14:15:22Z",
  • "updated_at": "2022-09-22T17:02:13Z",
  • "archived_at": null
}

Delete a client

Delete a client. Can be performed by Admin or Member users only. Clients with requests attached can only be deleted by Admin users.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Retrieve address for a client

Retrieve address for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier.

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D/address \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "address",
  • "unit": "3rd Floor",
  • "house_name": "Citypoint",
  • "house_number": "65",
  • "street_name": "Haymarket Terrace",
  • "second_street": null,
  • "district": null,
  • "city": "Edinburgh",
  • "province": null,
  • "postcode": "EH12 5HD",
  • "country": "GB"
}

Replace an address for a client

Replace address for a client.

Each country has its own field requirements. Any field can become required if the selected country demands it, most commonly postcode.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier.

Request Body schema: application/json
non-empty
unit
null or string

Unit, flat or apartment name or number.

house_name
null or string

House or building name.

house_number
null or string

House or building number.

street_name
null or string

First line of the street name.

second_street
null or string

Second line of the street name if applicable.

district
null or string

District, town, village, suburb or equivalent.

city
null or string

City name if applicable.

province
null or string

Province, county, municipality, township or equivalent.

postcode
null or string

Postcode, zip code or equivalent.

country
null or string
Enum: "AF" "AX" "AL" "DZ" "AS" "AD" "AO" "AI" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "KH" "CA" "CV" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CG" "CD" "CK" "CR" "HR" "CU" "CW" "CY" "CZ" "CI" "DK" "DJ" "DM" "DO" "EC" "EG" "SV" "GQ" "ER" "EE" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GR" "GL" "GD" "GP" "GU" "GT" "GG" "GN" "GW" "GY" "HT" "HM" "VA" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IM" "IL" "IT" "JM" "JP" "JE" "JO" "KZ" "KE" "KI" "KP" "XK" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LT" "LU" "MO" "MK" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "FM" "MD" "MC" "MN" "ME" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "AN" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "MP" "NO" "OM" "PK" "PS" "PW" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "CM" "RE" "RO" "RU" "RW" "BL" "SH" "KN" "LC" "MF" "PM" "WS" "SM" "ST" "SA" "SN" "RS" "SC" "SL" "SG" "SX" "SK" "SI" "SB" "SO" "ZA" "GS" "KR" "SS" "ES" "LK" "VC" "SD" "SR" "SJ" "SZ" "SE" "CH" "SY" "TW" "TJ" "TZ" "TH" "TL" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "US" "UM" "UY" "UZ" "VU" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "YU" "ZM" "ZW"

ISO3601 alpha-2 country code.

Responses

Request samples

Content type
application/json
{
  • "unit": "3rd Floor",
  • "house_name": "Citypoint",
  • "house_number": "65",
  • "street_name": "Haymarket Terrace",
  • "city": "Edinburgh",
  • "postcode": "EH12 5HD",
  • "country": "GB"
}

Response samples

Content type
application/json
{
  • "object": "address",
  • "unit": "3rd Floor",
  • "house_name": "Citypoint",
  • "house_number": "65",
  • "street_name": "Haymarket Terrace",
  • "second_street": null,
  • "district": null,
  • "city": "Edinburgh",
  • "province": null,
  • "postcode": "EH12 5HD",
  • "country": "GB"
}

List all forms for a client

List all forms for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
expand
Array of strings
Items Enum: "client" "record"
type
string
Enum: "internal" "requested"

Filter by internal client forms (internal), or requested for completion by the client (requested). Includes both by default.

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/clients/%7Bid%7D/forms?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&expand=SOME_ARRAY_VALUE&type=SOME_STRING_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Retrieve a form for a client

Retrieve a form for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
reference
required
string <uuid>

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D/forms/%7Breference%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
Example

A form for completion by the client

{
  • "object": "client_form",
  • "id": 37344,
  • "reference": "2ddb20b8-e0e3-45ae-a638-42610b990a6a",
  • "type": "requested",
  • "client": 73212,
  • "record": 87564,
  • "name": "New starter form",
  • "description": null,
  • "instructions": null,
  • "fields": [
    ],
  • "version": 1,
  • "created_at": "2022-10-11T13:41:38Z",
  • "updated_at": "2022-10-11T13:41:38Z",
  • "completed_at": null,
  • "archived_at": null
}

Download a form for a client

Download a form for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
reference
required
string <uuid>

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D/forms/%7Breference%7D/download \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

List all records for a client

List all records for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
expand
Array of strings
Items Value: "client"

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/clients/%7Bid%7D/records?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

List all files for a client

List all files for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer
query Parameters
expand
Array of strings
Items Value: "source"

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/clients/%7Bid%7D/files?expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
Example

An internal file attached directly to the client.

{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Download a file for a client

Download a file for a client.

Authorizations:
personal_tokenoauth
path Parameters
clientId
required
integer
fileId
required
integer

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/clients/%7BclientId%7D/files/%7BfileId%7D/download \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Client Assignees

List all assignees for a client

Returns a paginated list of the client's assignees.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier.

query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/clients/%7Bid%7D/assignees?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Set assignees for a client

Set the assignees for a client according to the exact values provided in the request, overwriting any existing assignees. To add additional assignees, refer to Update assignees for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier.

Request Body schema: application/json
Array (non-empty)
type
required
string
Value: "user"

The type of assignee to be assigned to the client.

user
required
integer

The unique identifier of the user to be assigned to the client.

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Update assignees for a client

Add one or more assignees to a client, merging them with existing assignees.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier.

Request Body schema: application/json
Array (non-empty)
Any of
type
required
string
Value: "user"

The type of assignee to be assigned to the client.

user
required
integer

The unique identifier of the user to be assigned to the client.

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 3,
  • "count": 3,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Delete assignees for a client

Remove all assignees from a client.

To delete a single client assignee, see Delete an assignee for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier.

Request Body schema: application/json
Schema not provided

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D/assignees \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

Delete an assignee for a client

Remove an assignee from a client.

To delete all client assignees, see Delete assignees for a client.

Authorizations:
personal_tokenoauth
path Parameters
clientId
required
integer

Unique client identifier.

assigneeId
required
integer

Unique assignee identifier.

Request Body schema: application/json
Schema not provided

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/clients/%7BclientId%7D/assignees/%7BassigneeId%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

Client Organisations

List all organisations for a client

Returns a paginated list of a client's organisation memberships.

To retrieve organisations for the team, refer to List all organisations.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/clients/%7Bid%7D/organisations?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Update organisations for a client

Add the client to one or more organisations, merging them with existing organisation memberships.

To update an organisation's basic details, refer to Update an organisation.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

Request Body schema: application/json
Array (non-empty)
integer

Unique organisation identifier

Responses

Request samples

Content type
application/json
[
  • 4117
]

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Replace organisations for a client

Replaces a client's organisation memberships.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

Request Body schema: application/json
Array (non-empty)
integer

Unique organisation identifier

Responses

Request samples

Content type
application/json
[
  • 3970,
  • 4117
]

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Delete organisations for a client

Delete all of a client's organisation memberships.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique client identifier

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/clients/%7Bid%7D/organisations \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

Delete organisation for a client

Delete a single client organisation membership.

Authorizations:
personal_tokenoauth
path Parameters
clientId
required
integer

Unique client identifier

organisationId
required
integer

Unique organisation identifier

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/clients/%7BclientId%7D/organisations/%7BorganisationId%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "error": "Unauthenticated."
}

Steps

List all steps

List all steps available for use.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/steps?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 5,
  • "count": 5,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Validate steps

Validate steps and return costs.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
required
Array of (Credit report (TransUnion (object) or Equifax (object))) or Criminal record (object) or Dummy (object) or Thorntons Onboarding (object) or HSCNI Access NI (object) or (Identity report (TransUnion (object) or Equifax (object))) or NHS ESR (object) or Photo ID (object) or Employment history (object) or Banking information (object) or Face capture (object) or Watchlist (object) or Document Request (object) or Document Transfer (object) or Form (object) (Record Steps) non-empty

Responses

Request samples

Content type
application/json
Example

Steps containing an identity check and a standard Photo ID check with passport and driving licence document types enabled.

{
  • "steps": [
    ]
}

Response samples

Content type
application/json
Example

Validated steps containing an identity check and a standard Photo ID check with passport and driving licence document types enabled.

{
  • "object": "validated_steps",
  • "steps": [
    ]
}

Teams

List all team members

List all team members.

Authorizations:
personal_tokenoauth
path Parameters
teamId
required
integer

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/teams/%7BteamId%7D/members \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Retrieve a team member

Returns the member of a team.

Authorizations:
personal_tokenoauth
path Parameters
teamId
required
integer
teamMemberId
required
integer

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/teams/%7BteamId%7D/members/%7BteamMemberId%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "team_member",
  • "id": 121,
  • "name": "Lorraine Baines",
  • "email": "lorraine@example.com",
  • "role": "owner"
}

Organisations

Retrieve all organisations

Returns a paginated list of the team's organisations.

To retrieve a specific client's organisations, refer to List all organisations for a client.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/organisations?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Create an organisation

Create a new organisation.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
name
required
string <= 255

Organisation or company name The value is not formatted (e.g. title case), and appears as written.

company_number
null or string <= 255

The company registration number or reference

jurisdiction
null or string
Enum: "ae_az" "us_al" "us_ak" "al" "us_az" "us_ar" "aw" "au" "bs" "bh" "bd" "bb" "by" "be" "bz" "bm" "bo" "br" "bg" "us_ca" "kh" "ca" "us_co" "us_ct" "hr" "cw" "cy" "us_de" "dk" "us_dc" "do" "ae_du" "fi" "us_fl" "fr" "gf" "us_ga" "de" "gi" "gr" "gl" "gp" "gg" "us_hi" "hk" "is" "us_id" "in" "us_in" "us_ia" "ir" "ie" "im" "il" "jm" "jp" "je" "us_ks" "us_ky" "lv" "li" "us_la" "lu" "us_me" "my" "mt" "mq" "us_md" "us_ma" "mu" "yt" "mx" "us_mi" "us_mn" "us_ms" "us_mo" "md" "us_mt" "me" "mm" "us_ne" "nl" "us_nv" "ca_nb" "us_nh" "us_nj" "us_nm" "us_ny" "nz" "ca_nl" "us_nc" "us_nd" "no" "ca_ns" "us_oh" "us_ok" "us_or" "pk" "pa" "us_pa" "pl" "ca_pe" "pr" "ca_qc" "us_ri" "ro" "rw" "re" "bl" "mf" "pm" "sg" "sk" "si" "za" "us_sc" "us_sd" "es" "se" "ch" "tj" "tz" "us_tn" "us_tx" "th" "to" "tn" "ug" "ua" "gb" "us_ut" "vu" "us_vt" "vn" "us_va" "us_wa" "us_wv" "us_wi" "us_wy"

The country code or region where the company is registered.

Required if company_number is provided.

Responses

Request samples

Content type
application/json
{
  • "name": "Probert Publishing",
  • "company_number": "SF12188",
  • "jurisdiction": "gb"
}

Response samples

Content type
application/json
{
  • "object": "organisation",
  • "id": 3970,
  • "name": "Probert Publishing",
  • "company_number": "SF12188",
  • "jurisdiction": "gb",
  • "created_at": "2022-03-15T21:43:16Z",
  • "updated_at": "2022-03-15T21:43:16Z"
}

Retrieve an organisation

Returns a single organisation.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique organisation identifier

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/organisations/%7Bid%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "organisation",
  • "id": 3970,
  • "name": "Probert Publishing",
  • "company_number": "SF12188",
  • "jurisdiction": "gb",
  • "created_at": "2022-03-15T21:43:16Z",
  • "updated_at": "2022-03-15T21:43:16Z"
}

Update an organisation

Update the details of an organisation.

To add clients to or remove clients from the organisation, refer to Update organisations for a client.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique organisation identifier

Request Body schema: application/json
name
required
string <= 255

Organisation or company name The value is not formatted (e.g. title case), and appears as written.

company_number
null or string <= 255

The company registration number or reference

jurisdiction
null or string
Enum: "ae_az" "us_al" "us_ak" "al" "us_az" "us_ar" "aw" "au" "bs" "bh" "bd" "bb" "by" "be" "bz" "bm" "bo" "br" "bg" "us_ca" "kh" "ca" "us_co" "us_ct" "hr" "cw" "cy" "us_de" "dk" "us_dc" "do" "ae_du" "fi" "us_fl" "fr" "gf" "us_ga" "de" "gi" "gr" "gl" "gp" "gg" "us_hi" "hk" "is" "us_id" "in" "us_in" "us_ia" "ir" "ie" "im" "il" "jm" "jp" "je" "us_ks" "us_ky" "lv" "li" "us_la" "lu" "us_me" "my" "mt" "mq" "us_md" "us_ma" "mu" "yt" "mx" "us_mi" "us_mn" "us_ms" "us_mo" "md" "us_mt" "me" "mm" "us_ne" "nl" "us_nv" "ca_nb" "us_nh" "us_nj" "us_nm" "us_ny" "nz" "ca_nl" "us_nc" "us_nd" "no" "ca_ns" "us_oh" "us_ok" "us_or" "pk" "pa" "us_pa" "pl" "ca_pe" "pr" "ca_qc" "us_ri" "ro" "rw" "re" "bl" "mf" "pm" "sg" "sk" "si" "za" "us_sc" "us_sd" "es" "se" "ch" "tj" "tz" "us_tn" "us_tx" "th" "to" "tn" "ug" "ua" "gb" "us_ut" "vu" "us_vt" "vn" "us_va" "us_wa" "us_wv" "us_wi" "us_wy"

The country code or region where the company is registered.

Required if company_number is provided.

Responses

Request samples

Content type
application/json
{
  • "name": "Probert Publishing Co"
}

Response samples

Content type
application/json
{
  • "object": "organisation",
  • "id": 3970,
  • "name": "Probert Publishing Co",
  • "company_number": "SF12188",
  • "jurisdiction": "gb",
  • "created_at": "2022-03-15T21:43:16Z",
  • "updated_at": "2022-05-21T09:11:54Z"
}

Documents

List all documents

List all library documents.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
enabled
boolean
expand
Array of strings
Items Value: "attachment"

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/documents?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&enabled=SOME_BOOLEAN_VALUE&expand=SOME_ARRAY_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
Example

A single document with attachment expanded.

{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Templates

List all email templates

List all email templates.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
enabled
boolean

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/templates/emails?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&enabled=SOME_BOOLEAN_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

List all document templates

List all document templates.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
enabled
boolean

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/templates/documents?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&enabled=SOME_BOOLEAN_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

List all record templates

Note: The List all record templates endpoint is partially implemented. Some properties are temporarily unavailable.

List all record templates returns a paginated list of record templates associated with the team.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
enabled
boolean

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/templates/records?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&enabled=SOME_BOOLEAN_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Webhooks

List all webhooks

Returns a paginated list of webhooks.

To retrieve a webhook, refer to Retrieve a webhook.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
enabled
boolean

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/webhooks?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&enabled=SOME_BOOLEAN_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 2,
  • "count": 2,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Create a webhook

Create a webhook.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
url
required
string

The webhook delivery url.

events
required
Array of strings (WebhookSubscribeEvents) non-empty unique
Items Enum: "*" "client.*" "form.*" "record.*" "client.archived" "client.created" "client.deleted" "client.organisations" "client.record" "client.status" "client.unarchived" "client.updated" "form.attached" "form.deleted" "form.modified" "form.sent" "form.submitted" "form.updated" "record.bounced" "record.created" "record.finished" "record.reviewed" "record.unreviewed" "record.updated"

The event or events this webhook is subscribed to. Supports wildcards; * all events, client.* all client events, etc.

is_enabled
boolean
Default: true

Whether or not the webhook is currently enabled.

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "object": "webhook",
  • "id": 2154,
  • "uuid": "e4085749-1c11-4ac8-9361-df7f33c37ecb",
  • "url": "https://example.org/incoming/webhooks/amiqus",
  • "secret": "58585568aa4dc44c733bc244495fc1f2de3c2d2f56287c265274ab806f74bb34",
  • "events": [
    ],
  • "is_enabled": true,
  • "created_at": "2022-08-24T11:26:22Z",
  • "updated_at": "2022-08-24T11:26:22Z"
}

Retrieve a webhook

Retrieve a webhook.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique webhook identifier.

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/webhooks/%7Bid%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "webhook",
  • "id": 2154,
  • "uuid": "e4085749-1c11-4ac8-9361-df7f33c37ecb",
  • "url": "https://example.org/incoming/webhooks/amiqus",
  • "secret": "58585568aa4dc44c733bc244495fc1f2de3c2d2f56287c265274ab806f74bb34",
  • "events": [
    ],
  • "is_enabled": true,
  • "created_at": "2022-08-24T11:26:22Z",
  • "updated_at": "2022-08-24T11:26:22Z"
}

Update a webhook

Update a webhook.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique webhook identifier.

Request Body schema: application/json
url
string

The webhook delivery url.

events
Array of strings (WebhookSubscribeEvents) non-empty unique
Items Enum: "*" "client.*" "form.*" "record.*" "client.archived" "client.created" "client.deleted" "client.organisations" "client.record" "client.status" "client.unarchived" "client.updated" "form.attached" "form.deleted" "form.modified" "form.sent" "form.submitted" "form.updated" "record.bounced" "record.created" "record.finished" "record.reviewed" "record.unreviewed" "record.updated"

The event or events this webhook is subscribed to. Supports wildcards; * all events, client.* all client events, etc.

is_enabled
boolean

Whether or not the webhook is currently enabled.

Responses

Request samples

Content type
application/json
Example

Update both the URL and subscribed events.

{}

Response samples

Content type
application/json
{
  • "object": "webhook",
  • "id": 2154,
  • "uuid": "e4085749-1c11-4ac8-9361-df7f33c37ecb",
  • "url": "https://example.org/incoming/webhooks/amiqus",
  • "secret": "58585568aa4dc44c733bc244495fc1f2de3c2d2f56287c265274ab806f74bb34",
  • "events": [
    ],
  • "is_enabled": true,
  • "created_at": "2022-08-24T11:26:22Z",
  • "updated_at": "2022-08-24T11:26:22Z"
}

Delete a webhook

Delete a webhook.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique webhook identifier.

Responses

Request samples 

curl --request DELETE \
  --url https://id.amiqus.co/api/v2/webhooks/%7Bid%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "error": "Webhook not found"
}

List all deliveries for a webhook

List all deliveries for a webhook.

Authorizations:
personal_tokenoauth
path Parameters
id
required
integer

Unique webhook identifier.

query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/webhooks/%7Bid%7D/deliveries?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json

Example of a successful delivery for a ping event.

{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Forms

List all forms

List all forms.

Authorizations:
personal_tokenoauth
query Parameters
page
integer >= 1
limit
integer [ 1 .. 100 ]
enabled
boolean

Responses

Request samples 

curl --request GET \
  --url 'https://id.amiqus.co/api/v2/forms?page=SOME_INTEGER_VALUE&limit=SOME_INTEGER_VALUE&enabled=SOME_BOOLEAN_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "paginated_list",
  • "data": [
    ],
  • "total": 1,
  • "count": 1,
  • "limit": 100,
  • "current_page": 1,
  • "total_pages": 1,
  • "links": null
}

Create a form

Create a form.

Authorizations:
personal_tokenoauth
Request Body schema: application/json
name
required
string <= 255 characters
description
null or string <= 255 characters
null or TipTap Document (object)
required
Array of Section (object) or Heading (object) or Paragraph (object) or Short Answer (object) or Long Answer (object) or Single Choice (object) or Multiple Choice (object) or (Document (Manual (object) or Template (object))) (BuilderFields) >= 2 items

The first field must always be a Section. Any Fields not present in a Section are omitted.

is_enabled
boolean
Default: true

Responses

Request samples

Content type
application/json
Example

A simple form with two required fields inside a section.

{
  • "name": "New starter form",
  • "fields": [
    ]
}

Response samples

Content type
application/json
{
  • "object": "form_template",
  • "id": 45533,
  • "reference": "9b81f60f-2165-4e2c-b748-6c3071053e66",
  • "name": "New starter form",
  • "description": null,
  • "instructions": null,
  • "fields": [
    ],
  • "version": 4,
  • "is_enabled": true,
  • "created_at": "2022-08-24T11:26:22Z",
  • "updated_at": "2022-08-24T11:26:22Z",
  • "archived_at": null
}

Retrieve a form

Retrieve a form.

Authorizations:
personal_tokenoauth
path Parameters
reference
required
string <uuid>

Responses

Request samples 

curl --request GET \
  --url https://id.amiqus.co/api/v2/forms/%7Breference%7D \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response samples

Content type
application/json
{
  • "object": "form_template",
  • "id": 45533,
  • "reference": "9b81f60f-2165-4e2c-b748-6c3071053e66",
  • "name": "New starter form",
  • "description": null,
  • "instructions": null,
  • "fields": [
    ],
  • "version": 4,
  • "is_enabled": true,
  • "created_at": "2022-08-24T11:26:22Z",
  • "updated_at": "2022-08-24T11:26:22Z",
  • "archived_at": null
}

Update a form

Update a form.

Authorizations:
personal_tokenoauth
path Parameters
reference
required
string <uuid>
Request Body schema: application/json
non-empty
name
string <= 255 characters
description
null or string <= 255 characters
null or TipTap Document (object)
Array of Section (object) or Heading (object) or Paragraph (object) or Short Answer (object) or Long Answer (object) or Single Choice (object) or Multiple Choice (object) or (Document (Manual (object) or Template (object))) (BuilderFields) >= 2 items

The first field must always be a Section. Any Fields not present in a Section are omitted.

is_enabled
boolean

Responses

Request samples

Content type
application/json
Example

Update the "New starter form" adding a new multple choice answer.

{
  • "fields": [
    ]
}

Response samples

Content type
application/json
{
  • "object": "form_template",
  • "id": 45533,
  • "reference": "9b81f60f-2165-4e2c-b748-6c3071053e66",
  • "name": "New starter form",
  • "description": null,
  • "instructions": null,
  • "fields": [