get https://api.talkdeskapp.com/fsi/contacts/
Given the contact_id
Scope
fsi-contacts:read
Body Response - Schema
200 (the contact information)
| Parameter | Type | Description | Required |
|---|---|---|---|
| id | string | The contact ID from the external FSI institution (the ID must be used as the identified of the contact, to get its accounts, cards, payments and transactions). | yes |
| member_id | string | An identifier of the contact in the external FSI institution. For some cores it can be social_security, or other contact property, or even equal to the ID (don't use this property as the contact identifier to get its accounts, cards, payments and transactions). | yes |
| name | string | contact name | yes |
| contacts | array[object] | "contacts" subdivides into: 1 - "id" (string) - identification for contact point. Required. 2 - "type" (string) - define the type for this contact point. Allowed values: "PHONE", "EMAIL", "SMS", "OTHER". Required. 3 - "value" (string) - the actual contact point details. Required. 4 - "use" (string) - purpose of this contact point. Allowed values: "HOME", "WORK", "MOBILE", "TEMPORARY", "OLD". Required. 5 - "rank" (integer) - specify preferred order of use (0 = highest); >= 0. Required. | yes |
| addresses | array[object] | "addresses" subdivides into: 1 - "id" (string) - identification for the address. 2 - "type" (string) - address type. Allowed values: "POSTAL", "PHYSICAL", "BOTH". 3 - "street" (string) - street name address (can be Street, Avenue, Square, etc.). 4 - "city" (string) - name of city, town etc. 5 - "district" (string) - district name (aka county). 6 - "district" (string) - district name (aka county). 7 - "state" (string) - sub-unit of country (abbreviations are ok). 8 - "postal_code" (string) 9 - "country" (string) - country (e.g. can be ISO 3166 2 or 3-letter code). | yes |
| id_document_number | string | document number associated to a person | no |
| id_document_type | string | Allowed values: "SOCIAL_SECURITY", "DRIVER_LICENSE", "PASSPORT", "NATIONAL_ID", "OTHER" | no |
| birth_date | string | n/a | yes |
| _links | object | "_links" (object) - self link item for HAL. 1 - "self" (object) - link of the current page. Required. 1.1 - "href" (string) - address of the resource. | no |
400 (bad request), 401 (unauthorized), 403 (forbidden)
| Parameter | Type | Description | Required |
|---|---|---|---|
| code | string | n/a | yes |
| message | string | n/a | yes |
| description | string | n/a | no |
| fields | array[object] | "fields" subdivides into: "name" (string) "description" (string) | yes (name and description) |
API Availability
The FSI Integrations API is only available for customers enrolled in Talkdesk's Early Access (EA) program.
To enter the EA program, contact a Customer Success Manager.The FSI Integrations API has been in EA since December 2022.
Troubleshooting
If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.