GET
/
v1
/
sourceOfFunds
/
:userid
curl https://v2.app-dev.zquence.com/v1/sourceOfFunds/6a25cdac36bc6230704b5b59 \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

[
  {
    "_id": "6a3a590d3771fd3bd9210dd9",
    "userid": "6a25cdac36bc6230704b5b59",
    "accountId": "6a1ea31b892791af056f46bd",
    "tenantId": "bc41c6ab-7206-4033-b632-4d1cfa86d840",
    "environmentId": "69f9b5fa0600ccbf9c677005",
    "approvedSourceIds": ["src_9a8b7c6d"],
    "createdAt": "2026-05-20T10:30:00.000Z",
    "updatedAt": "2026-06-07T20:00:12.414Z"
  }
]
Returns the source-of-funds records a customer has submitted, newest first. Records attached to archived accounts are excluded.
Requires API-key scope source-of-funds.read. The query is tenant-scoped, so a userid outside your tenant simply matches nothing.

​
Path parameters

​
userid
string
required
The customer’s MongoDB ObjectId, as returned by List customers.

​
Query parameters

​
accountId
string
Return only the most recent record for this account. Without it the endpoint returns every record for the customer as an array; with it, a single object.

​
Returns

Without accountId, an array of record objects. With accountId, a single object, or null when that account has no record.
​
_id
string
Record identifier.
​
userid
string
Customer the record belongs to.
​
accountId
string
Account the record was submitted against. Older records may carry transactionId instead.
​
tenantId
string
Owning tenant identifier.
​
environmentId
string | null
Environment the record lives in.
​
approvedSourceIds
string[]
Identifiers of the sources on this record that have been approved by a reviewer.
​
createdAt
string
ISO 8601 UTC creation timestamp.
​
updatedAt
string
ISO 8601 UTC last-updated timestamp.

​
Empty results

A customer with no submitted records returns 200 with an empty array — not an error. A customer whose only records belong to archived accounts returns 404, because after archived records are filtered out there is nothing left to return.

​
Error codes

StatusMeaning
401Missing or invalid API key pair.
403The API key lacks the source-of-funds.read scope.
404Every record for this customer belongs to an archived account.
curl https://v2.app-dev.zquence.com/v1/sourceOfFunds/6a25cdac36bc6230704b5b59 \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

[
  {
    "_id": "6a3a590d3771fd3bd9210dd9",
    "userid": "6a25cdac36bc6230704b5b59",
    "accountId": "6a1ea31b892791af056f46bd",
    "tenantId": "bc41c6ab-7206-4033-b632-4d1cfa86d840",
    "environmentId": "69f9b5fa0600ccbf9c677005",
    "approvedSourceIds": ["src_9a8b7c6d"],
    "createdAt": "2026-05-20T10:30:00.000Z",
    "updatedAt": "2026-06-07T20:00:12.414Z"
  }
]