Sign in
DIR References

Submit a DIR's references

Submit the two business references and one financial reference for a DIR.

The DIR's authorizer email must be verified first (see the email-verification endpoint). Until it is, this returns 409 and no references are stored.

The request body carries exactly two business references plus one financial reference. On success the references are stored and the response echoes them in the same shape as the GET. Submitting again converges on the already-stored references rather than erroring.

post/dir/{dir_id}/references

Path parameters

dir_idstring uuid required
Example:16635d38-75a6-4481-82e8-69af60e05011

The DIR id. Lowercase UUID.

Request body

Example request

{
  "business_references": [
    {
      "email": "dana.reyes@example.com",
      "full_name": "Dana Reyes",
      "job_title": "VP of Operations",
      "organization": "Acme Logistics",
      "phone_e164": "+14155550123",
      "relationship_to_registrant": "Supplier",
      "timezone": "America/New_York"
    }
  ],
  "financial_reference": {
    "email": "dana.reyes@example.com",
    "full_name": "Dana Reyes",
    "job_title": "VP of Operations",
    "organization": "Acme Logistics",
    "phone_e164": "+14155550123",
    "relationship_to_registrant": "Supplier",
    "timezone": "America/New_York"
  }
}

Response

The stored references.

Example response

{
  "data": [
    {
      "email": "dana.reyes@example.com",
      "full_name": "Dana Reyes",
      "job_title": "VP of Operations",
      "organization": "Acme Logistics",
      "phone_e164": "+14155550123",
      "record_type": "dir_reference",
      "ref_type": "business",
      "relationship_to_registrant": "Supplier",
      "timezone": "America/New_York"
    }
  ]
}

Changes