Get EDD Requests

GET	https://api.sfox.com/v1/enterprise/eddq/requests

Returns a list of all EDD requests that have been created for your end users.

For additional details regarding EDD and completing EDD requests, see our Enhanced Due Diligence (EDD) guide.

---

Request

Query Parameters

Parameter	Description
user_id	Filters the response EDD requests for a specific end user according to the specified user_id.

Example Requests

Shell

curl -X GET \
  -H  "Authorization: Bearer ${ENTERPRISE_API_KEY}" \
   'https://api.sfox.com/v1/enterprise/eddq/requests'

NodeJS

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api.sfox.com/v1/enterprise/eddq/requests',
  headers: { 
    'Authorization': `Bearer ${process.env.ENTERPRISE_API_KEY}`, 
  }
};

axios.request(config)
  .then((response) => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.status);
    console.log(error.response.data);
  });

Python

import requests
import os


response = requests.get('https://api.sfox.com/v1/enterprise/eddq/requests',
  headers={ 
    'Authorization': f"Bearer {os.environ['ENTERPRISE_API_KEY']}" 
  })

print(response.status_code)
print(response.json())

Response

Response Body

EDD requests with status = REQUESTED or PARTIAL_SUBMISSION are considered "oustanding" and must be completed.

Key	Description
id	The unique, sFOX-generated ID of the EDD request.
user_id	The unique ID of the user shared between sFOX and you.
ddq_id	The ID of the type of EDDQ (Enhanced Due Diligence Questionnaire)
required_form	The name of the EDDQ based on the ddq_id. Possible values: EDDQ - Individual EDDQ - Business
status	The completion status of the EDDQ.
date_added	The date that the EDDQ request was added.
date_updated	The date that the EDDQ request was most recently updated.

Responses

200: OK

All users

{
"data": [
        {
            "id": 1,
            "user_id": "187ce1a6-dd9d-4a6a-9a79-71425584e3ba",
            "ddq_id": 1,
            "required_form": "EDDQ - Individual",
            "status": "IN_REVIEW",
            "date_added": "2024-03-20T00:16:52.000Z",
            "date_updated": "2024-03-20T00:16:52.000Z"
        },
        {
            "id": 6,
            "user_id": "testing",
            "ddq_id": 1,
            "required_form": "EDDQ - Individual",
            "status": "REVIEWED",
            "date_added": "2024-03-29T16:55:55.000Z",
            "date_updated": "2024-03-29T16:55:55.000Z"
        },
        {
            "id": 8,
            "user_id": "clelele",
            "ddq_id": 1,
            "required_form": "EDDQ - Individual",
            "status": "REQUESTED",
            "date_added": "2024-04-03T17:57:25.000Z",
            "date_updated": "2024-04-03T17:57:25.000Z"
        }
    ]
}