users
transfers
payout-links
payout-batches
payments
payment-intents
payment-customers
checkout-sessions
accounts-payable
- GETList all vendors
- POSTCreate a vendor
- GETGet vendor details
- DELDelete a vendor
- GETList all payment methods for a vendor
- POSTCreate a payment method for a vendor
- GETGet vendor payment method details
- DELDelete a vendor payment method
- GETList all payables
- POSTCreate a payable
- POSTCreate a payable from a file
- GETGet payable details
- PATCHUpdate a payable
- POSTUpload file to the payable
- DELDelete file from the payable
- POSTCancel a payable
- POSTSubmit a payable for approval
- POSTApprove a payable
- POSTReject a payable
- POSTPay a payable
- GETList all approval policies
- POSTCreate an approval policy
- DELDelete an approval policy
- PATCHUpdate priority of an approval policy
- GETList all approvers for api app
apps
- GETList all Apps
- POSTCreate an App
- GETRetrieve an App
- GETRetrieve an App's Compliance Information
- PUTUpdate an App's Compliance Information
- GETGet App ACH Account
- PUTAdd App ACH Account
- POSTDeposit Funds into App Wallet
- POSTWithdraw Funds From App Wallet
- POSTRefresh compliance flow
- POSTUpdate an application's settings
payment-methods
curl --request GET \
--url https://api.dots.dev/api/v2/users \
--header 'Authorization: Basic <encoded-value>'{
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "<string>",
"last_name": "<string>",
"email": "[email protected]",
"phone_number": {
"country_code": "<string>",
"phone_number": "<string>"
},
"default_payout_method": "ach",
"default_payout_method_details": {
"platform": "ach",
"id": "<string>",
"description": "<string>",
"mask": "<string>",
"email": "<string>",
"phone_number": "<string>",
"cash_tag": "<string>",
"country": "<string>",
"currency": "<string>",
"rtp_enabled": true,
"meta": "<unknown>"
},
"wallet": {
"amount": 123,
"withdrawable_amount": 123,
"credit_balance": 123
},
"status": "verified",
"compliance": {
"tax_id_collected": true,
"tax_id_verification": "unsubmitted",
"address_collected": true,
"date_of_birth_collected": true,
"must_collect_1099": true,
"1099_collected": true,
"w8_ben_collected": true,
"flagged": true,
"id_verified": true,
"has_criminal_activity": true,
"w9": {
"entity_type": "individual",
"business_name": "<string>",
"tax_id_collected": true,
"address_collected": true
},
"flags": {
"ofac": true,
"ofac_status": "unflagged",
"payout_method": true,
"payout_method_cycle": true
}
},
"metadata": "<string>"
}
],
"has_more": true
}List all Users
List all users connected to your application.
curl --request GET \
--url https://api.dots.dev/api/v2/users \
--header 'Authorization: Basic <encoded-value>'{
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "<string>",
"last_name": "<string>",
"email": "[email protected]",
"phone_number": {
"country_code": "<string>",
"phone_number": "<string>"
},
"default_payout_method": "ach",
"default_payout_method_details": {
"platform": "ach",
"id": "<string>",
"description": "<string>",
"mask": "<string>",
"email": "<string>",
"phone_number": "<string>",
"cash_tag": "<string>",
"country": "<string>",
"currency": "<string>",
"rtp_enabled": true,
"meta": "<unknown>"
},
"wallet": {
"amount": 123,
"withdrawable_amount": 123,
"credit_balance": 123
},
"status": "verified",
"compliance": {
"tax_id_collected": true,
"tax_id_verification": "unsubmitted",
"address_collected": true,
"date_of_birth_collected": true,
"must_collect_1099": true,
"1099_collected": true,
"w8_ben_collected": true,
"flagged": true,
"id_verified": true,
"has_criminal_activity": true,
"w9": {
"entity_type": "individual",
"business_name": "<string>",
"tax_id_collected": true,
"address_collected": true
},
"flags": {
"ofac": true,
"ofac_status": "unflagged",
"payout_method": true,
"payout_method_cycle": true
}
},
"metadata": "<string>"
}
],
"has_more": true
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Query Parameters
Filter users by status. Users that are in_review are users that have been flagged for fraud risk and is pending review.
verified, unverified, in_review, disabled A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with aaa, your subsequent call can include starting_after=aaa in order to fetch the next page of the list.
A limit on the number of objects to be returned, between 1 and 100.
A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with aaa, your subsequent call can include ending_before=aaa in order to fetch the previous page of the list.
Response
OK
Array of user objects.
Show child attributes
Show child attributes
ach, paypal, venmo, cash_app, intl_bank, airtm, payoneer Show child attributes
Show child attributes
ach, paypal, venmo, cash_app, intl_transfer, airtm, payoneer ID of the payment-method.
Indicates if RTP is enabled for the payment method (applies to ach only).
Optional metadata for the payout method. Can be any valid JSON value (object, string, number, boolean, array, or null).
verified, unverified, disabled, in_review Show child attributes
Show child attributes
Deprecated. Use w9.tax_id_collected instead.
Tax ID verification status. A mismatched tax ID may be corrected and resubmitted.
unsubmitted, pending, matched, mismatched Deprecated. Use w9.address_collected instead.
The user's date of birth was collected.
The user's 1099 information needs to be collected to resume payouts.
The user's 1099 information was collected.
The user's W8-BEN information was collected.
The user is flagged for review. For more information, see the flags object.
The user's id was verified.
The user has criminal activity based on a background check.
Information about the user's W9 form. null if the user is not a US individual or business.
Show child attributes
Show child attributes
True when the user is flagged for potential OFAC compliance issues.
Status of the user's OFAC compliance verification.
unflagged, id_verification_required, in_review, flagged True when two or more users share the same payout method.
True when the user has connected or disconnected payout methods repeatedly over a short period of time.
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
true if there are more objects.
Was this page helpful?