> ## Documentation Index
> Fetch the complete documentation index at: https://developer.fin.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Attach Documents to Individual Customer
> Attach proof of identity and proof of address documents to an existing individual customer
Before calling this endpoint, upload documents using the [Upload document](https://developer.fin.com/api-reference/customers/upload-document) endpoint
to obtain the URIs needed for the `files` arrays.
The `tos_policies_value` should be parsed from the `tos_policies_url` query parameter
returned from the Create Individual Customer endpoint.
## OpenAPI
````yaml POST /v1/customers/individual/attach
openapi: 3.1.0
info:
title: Fin.com API
version: 1.0.0
description: A simple API specification
servers:
- url: https://sandbox.api.fin.com
description: Sandbox server
- url: https://api.fin.com
description: Production server
security: []
tags:
- name: Authentication
description: A modified OAuth 2.0 Client Credential Flow
- name: Customers
description: Customer management and document upload operations
- name: Balances
description: Retrieve wallet balance information
- name: Catalogue
description: |
A set of endpoints to retrieve contextual data to assemble requests
to fin.com's API
- name: Beneficiaries
description: Manage beneficiary accounts for payments and transfers
- name: Transactions
description: Transaction history and management for beneficiaries
- name: Virtual Accounts
description: Create and manage virtual accounts for USD to USDC conversions
- name: Fees & FX Rates
description: Retrieve fees and foreign exchange rates
paths:
/v1/customers/individual/attach:
post:
tags:
- Customers
summary: Attach Documents to Individual Customer
description: >-
Attach proof of identity and proof of address documents to an existing
individual customer
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AttachDocumentForIndividualCustomerInput'
responses:
'200':
description: Documents attached successfully
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
customer_id:
type: string
format: uuid
example: 55bd6b4e-c20a-4cc8-9535-91d5557a67d9
'401':
$ref: '#/components/responses/AuthenticationError'
'422':
$ref: '#/components/responses/ValidationError'
security:
- bearerAuth: []
components:
schemas:
AttachDocumentForIndividualCustomerInput:
type: object
required:
- customer_id
- proof_of_identity
- proof_of_address
- tos_policies_value
properties:
customer_id:
type: string
format: uuid
example: 55bd6b4e-c20a-4cc8-9535-91d5557a67d9
proof_of_identity:
$ref: '#/components/schemas/ProofOfIdentity'
proof_of_address:
$ref: '#/components/schemas/ProofOfAddressIndividual'
tos_policies_value:
type: string
example: e9414388-fbdf-4407-b5c2-bc39eae3645b
ProofOfIdentity:
type: object
required:
- type
- number
- country
- issue_date
- expiry_date
- files
properties:
type:
type: string
enum:
- PASSPORT
- NATIONAL_ID
- DRIVERS_LICENSE
- RESIDENCE_PERMIT
description: |
- `PASSPORT` — Passport
- `NATIONAL_ID` — National ID card
- `DRIVERS_LICENSE` — Driver's license
- `RESIDENCE_PERMIT` - Residence permit
example: PASSPORT
number:
type: string
example: A12345678
country:
$ref: '#/components/schemas/CountryCode'
issue_date:
type: string
format: date
example: '2020-01-15'
expiry_date:
type: string
format: date
example: '2030-01-15'
files:
type: array
items:
type: object
required:
- uri
properties:
side:
type: string
enum:
- FRONT
- BACK
example: FRONT
uri:
type: string
example: /AbAcQ4hn_0652746727637.pdf
ProofOfAddressIndividual:
type: object
description: The proof of address document must not be older than three months.
required:
- type
- country
- files
properties:
type:
type: string
enum:
- PASSPORT
- NATIONAL_ID
- DRIVERS_LICENSE
- RESIDENCE_PERMIT
- UTILITY_BILL
- GOVERNMENT_LETTER
- BANK_STATEMENT
example: UTILITY_BILL
country:
$ref: '#/components/schemas/CountryCode'
files:
type: array
items:
type: object
required:
- uri
properties:
uri:
type: string
example: /AbAcQ4hn_0652746727638.pdf
CountryCode:
type: string
description: ISO 3166-1 alpha-3 country code
example: USA
enum:
- AFG
- ALB
- DZA
- ASM
- AND
- AGO
- AIA
- ATA
- ATG
- ARG
- ARM
- ABW
- AUS
- AUT
- AZE
- BHS
- BHR
- BGD
- BRB
- BLR
- BEL
- BLZ
- BEN
- BMU
- BTN
- BOL
- BES
- BIH
- BWA
- BVT
- BRA
- IOT
- BRN
- BGR
- BFA
- BDI
- CPV
- KHM
- CMR
- CAN
- CYM
- CAF
- TCD
- CHL
- CHN
- CXR
- CCK
- COL
- COM
- COD
- COG
- COK
- CRI
- HRV
- CUB
- CUW
- CYP
- CZE
- CIV
- DNK
- DJI
- DMA
- DOM
- ECU
- EGY
- SLV
- GNQ
- ERI
- EST
- SWZ
- ETH
- FLK
- FRO
- FJI
- FIN
- FRA
- GUF
- PYF
- ATF
- GAB
- GMB
- GEO
- DEU
- GHA
- GIB
- GRC
- GRL
- GRD
- GLP
- GUM
- GTM
- GGY
- GIN
- GNB
- GUY
- HTI
- HMD
- VAT
- HND
- HKG
- HUN
- ISL
- IND
- IDN
- IRN
- IRQ
- IRL
- IMN
- ISR
- ITA
- JAM
- JPN
- JEY
- JOR
- KAZ
- KEN
- KIR
- PRK
- KOR
- KWT
- KGZ
- LAO
- LVA
- LBN
- LSO
- LBR
- LBY
- LIE
- LTU
- LUX
- MAC
- MDG
- MWI
- MYS
- MDV
- MLI
- MLT
- MHL
- MTQ
- MRT
- MUS
- MYT
- MEX
- FSM
- MDA
- MCO
- MNG
- MNE
- MSR
- MAR
- MOZ
- MMR
- NAM
- NRU
- NPL
- NLD
- NCL
- NZL
- NIC
- NER
- NGA
- NIU
- NFK
- MNP
- NOR
- OMN
- PAK
- PLW
- PSE
- PAN
- PNG
- PRY
- PER
- PHL
- PCN
- POL
- PRT
- PRI
- QAT
- MKD
- ROU
- RUS
- RWA
- REU
- BLM
- SHN
- KNA
- LCA
- MAF
- SPM
- VCT
- WSM
- SMR
- STP
- SAU
- SEN
- SRB
- SYC
- SLE
- SGP
- SXM
- SVK
- SVN
- SLB
- SOM
- ZAF
- SGS
- SSD
- ESP
- LKA
- SDN
- SUR
- SJM
- SWE
- CHE
- SYR
- TWN
- TJK
- TZA
- THA
- TLS
- TGO
- TKL
- TON
- TTO
- TUN
- TUR
- TKM
- TCA
- TUV
- UGA
- UKR
- ARE
- GBR
- UMI
- USA
- URY
- UZB
- VUT
- VEN
- VNM
- VGB
- VIR
- WLF
- ESH
- YEM
- ZMB
- ZWE
- ALA
responses:
AuthenticationError:
description: Authentication failed due to invalid credentials
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Authentication failed
ValidationError:
description: Failed due to a formatting error.
content:
application/json:
schema:
type: object
required:
- message
properties:
message:
type: string
errors:
type: array
items:
type: object
additionalProperties:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
Bearer token authentication. Obtain token from [Issue a
Token](https://developer.fin.com/api-reference/authentication/issue-a-token)
endpoint
````