Fiskil Docs

Search Customers by email

Used during authentication to lookup customer data based on email address. Customers will be authenticated via OTP before data sharing is authorised.

POST
/auth/v1/customer/search

Used during authentication to lookup customer data based on email address. Customers will be authenticated via OTP before data sharing is authorised.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

email of customer

emailstringrequired

The email address of the end-user trying to authenticate. The API should return any customers that this end-user is associated with. The user may be the owner of the customer or just an authorized contact. For example, the same email may be associated with an individual customer and a business customer. Both customers should be returned.

Response Body

application/json

curl -X POST "https://example.com/auth/v1/customer/search" \  -H "Content-Type: application/json" \  -d '{    "email": "example@acme-corp.com"  }'
{  "data": [    {      "id": "customerid",      "name": "givenName familyName",      "phoneNumber": "+6141234567890"    }  ]}