Retrieve a W-8BEN

Retrieves the details of an existing W-8BEN document.

Path parameters

documentIdstringRequired

The unique identifier for an existing document.

Response

idstring

The unique identifier for the W-8BEN document.

createdAtdatetime

The date and time in ISO 8601 format when the W-8BEN document was created.

expiresAtdatetime

The date and time in ISO 8601 format when the W-8BEN is expired and requires re-collection.

urlstring

The URL to the W-8BEN document.

payeeobject

formFieldsobject

userIdstringOptional

The unique identifier for a single end-user of your application.

Errors

1 curl https://sandbox-api.withabound.com/v4/documents/w-8ben/documentId_samplexEM8PRV7sh \ 2 -H "Authorization: Bearer <apiKey>"

1 { 2 "id": "documentId_samplexEM8PRV7sh", 3 "createdAt": "2024-01-01T00:00:00.000Z", 4 "expiresAt": "2028-01-01T00:00:00.000Z", 5 "url": "https://tax-documents-sandbox.s3.us-west-2.amazonaws.com/FORM-W-8BEN.pdf", 6 "payee": { 7 "citizenshipCountry": "GB", 8 "dateOfBirth": "1982-12-10", 9 "name": "Ada Lovelace", 10 "permanentResidenceAddress": { 11 "address": "43 Hilly Fields", 12 "country": "GB", 13 "address2": "Suite 32", 14 "city": "Lewisham", 15 "state": "London", 16 "postalCode": "SE13 7JN" 17 }, 18 "foreignTin": "*******6C", 19 "foreignTinFingerprint": "tinFingerprint_sampleanXo4V9nL9", 20 "mailingAddress": { 21 "address": "256 Byron Street", 22 "country": "US", 23 "address2": "Suite 32", 24 "city": "Palo Alto", 25 "state": "CA", 26 "postalCode": "94306" 27 }, 28 "tin": "*******00", 29 "tinFingerprint": "tinFingerprint_samplehy2BWO6JJG", 30 "tinType": "INDIVIDUAL", 31 "tinVerificationId": "tinVerificationId_sample41SD71AV8f", 32 "tinVerificationStatus": "MATCH" 33 }, 34 "formFields": { 35 "taxClassification": "INDIVIDUAL", 36 "isCertified": true, 37 "isForeignTinNotRequired": false, 38 "taxTreatyBenefits": { 39 "residentCountry": "GB", 40 "claimedProvision": "7", 41 "rateOfWithholding": 0, 42 "incomeCode": "17", 43 "incomeType": "SERVICES", 44 "additionalConditions": "Independent personal services performed in the US" 45 }, 46 "referenceNumbers": [ 47 "123456789" 48 ], 49 "electronicSignature": { 50 "signature": "Ada Lovelace", 51 "printedName": "Ada Lovelace", 52 "signedAt": "2024-01-01T00:00:00.000Z", 53 "ipAddress": "127.0.0.1" 54 } 55 } 56 }

1	curl https://sandbox-api.withabound.com/v4/documents/w-8ben/documentId_samplexEM8PRV7sh \
2	-H "Authorization: Bearer <apiKey>"

1	{
2	"id": "documentId_samplexEM8PRV7sh",
3	"createdAt": "2024-01-01T00:00:00.000Z",
4	"expiresAt": "2028-01-01T00:00:00.000Z",
5	"url": "https://tax-documents-sandbox.s3.us-west-2.amazonaws.com/FORM-W-8BEN.pdf",
6	"payee": {
7	"citizenshipCountry": "GB",
8	"dateOfBirth": "1982-12-10",
9	"name": "Ada Lovelace",
10	"permanentResidenceAddress": {
11	"address": "43 Hilly Fields",
12	"country": "GB",
13	"address2": "Suite 32",
14	"city": "Lewisham",
15	"state": "London",
16	"postalCode": "SE13 7JN"
17	},
18	"foreignTin": "*******6C",
19	"foreignTinFingerprint": "tinFingerprint_sampleanXo4V9nL9",
20	"mailingAddress": {
21	"address": "256 Byron Street",
22	"country": "US",
23	"address2": "Suite 32",
24	"city": "Palo Alto",
25	"state": "CA",
26	"postalCode": "94306"
27	},
28	"tin": "*******00",
29	"tinFingerprint": "tinFingerprint_samplehy2BWO6JJG",
30	"tinType": "INDIVIDUAL",
31	"tinVerificationId": "tinVerificationId_sample41SD71AV8f",
32	"tinVerificationStatus": "MATCH"
33	},
34	"formFields": {
35	"taxClassification": "INDIVIDUAL",
36	"isCertified": true,
37	"isForeignTinNotRequired": false,
38	"taxTreatyBenefits": {
39	"residentCountry": "GB",
40	"claimedProvision": "7",
41	"rateOfWithholding": 0,
42	"incomeCode": "17",
43	"incomeType": "SERVICES",
44	"additionalConditions": "Independent personal services performed in the US"
45	},
46	"referenceNumbers": [
47	"123456789"
48	],
49	"electronicSignature": {
50	"signature": "Ada Lovelace",
51	"printedName": "Ada Lovelace",
52	"signedAt": "2024-01-01T00:00:00.000Z",
53	"ipAddress": "127.0.0.1"
54	}
55	}
56	}