Skip to main content
GET
/
fdx
/
v6
/
customer
/
{customerId}
/
accounts
/
{accountId}
/
contact
Get an account's contact information
curl --request GET \
  --url https://api.provider.fiskil.com/fdx/v6/customer/{customerId}/accounts/{accountId}/contact \
  --header 'Authorization: Bearer <token>'
{
  "holders": [
    {
      "relationship": "SECONDARY",
      "name": {
        "first": "Ernest",
        "middle": "Miller",
        "last": "Hemingway",
        "suffix": "IV"
      }
    },
    {
      "relationship": "PRIMARY_JOINT",
      "name": {
        "first": "Maya",
        "last": "Angelou",
        "middle": "Annie"
      }
    }
  ],
  "emails": [
    "ernest.m.hemingway@domain.tld",
    "m.angelou@domain.tld"
  ],
  "addresses": [
    {
      "line1": "1850 N Clark St",
      "line2": "Apartment 103",
      "city": "Chicago",
      "region": "IL",
      "postalCode": "60614",
      "country": "US"
    },
    {
      "line1": "2014 N Main St",
      "city": "San Francisco",
      "region": "CA",
      "postalCode": "94105",
      "country": "US"
    }
  ],
  "telephones": [
    {
      "type": "HOME",
      "country": "1",
      "number": "3127771926"
    },
    {
      "type": "CELL",
      "country": "53",
      "number": "45915607"
    },
    {
      "type": "HOME",
      "country": "1",
      "number": "4157771926"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

The Fiskil Data Provider will include a self-signed JWT as a Bearer token in the Authorization header. You should verify this JWT using the JWKS URL you can find for your Data Provider instance in the Fiskil Console. To verify the JWT you must:

  • Verify the signature
  • Ensure the token has not expired by checking the exp claim
  • The sub and iss claims are your data provider subdomain
  • The aud claim is the URI of the resource being requested (excluding any query parameters)
  • The jti value is unique For further detail on security and authentication refer to our Authentication documentation

Path Parameters

​
accountId
string
required

Account identifier, found in the GET /accounts endpoint response.

Note: If the status of the accountId provided is RESTRICTED, you can send a 200 response with an empty body to indicate that no payment networks are available at this time.

Value for a unique identifier

Maximum string length: 256
Example:

"someLongTermUniqueIDString"

​
customerId
string
required

Unique identifier for the user the account belongs to. This will be the user that authorized the data sharing.

Value for a unique identifier

Maximum string length: 256
Example:

"someLongTermUniqueIDString"

Response

Details used to verify an account

Details used to verify an account

​
holders
Account Holder entity · object[]
required

Owners of the account.

Minimum array length: 1
Example:
[
  {
    "relationship": "SECONDARY",
    "name": {
      "first": "Ernest",
      "middle": "Miller",
      "last": "Hemingway",
      "suffix": "IV"
    }
  },
  {
    "relationship": "PRIMARY_JOINT",
    "name": {
      "first": "Maya",
      "last": "Angelou",
      "middle": "Annie"
    }
  }
]
​
emails
string[]
required

Email addresses associated with the account

Minimum array length: 1
Example:
[
  "ernest.m.hemingway@domain.tld",
  "m.angelou@domain.tld"
]
​
addresses
Delivery Address · object[]
required

Physical mail addresses associated with the account

Minimum array length: 1
Example:
[
  {
    "line1": "1850 N Clark St",
    "line2": "Apartment 103",
    "city": "Chicago",
    "region": "IL",
    "postalCode": "60614",
    "country": "US"
  },
  {
    "line1": "2014 N Main St",
    "city": "San Francisco",
    "region": "CA",
    "postalCode": "94105",
    "country": "US"
  }
]
​
telephones
Telephone Number · object[]
required

Telephone numbers associated with the account

Minimum array length: 1
Example:
[
  {
    "type": "HOME",
    "country": "1",
    "number": "3127771926"
  },
  {
    "type": "CELL",
    "country": "53",
    "number": "45915607"
  },
  {
    "type": "HOME",
    "country": "1",
    "number": "4157771926"
  }
]