# Customers ### Add a New Customer To add a new customer to the system, use the authenticated `/customer` `POST` endpoint. This will initialise a new customer entity and start KYC verification process. The response contains a verification URL that redirects to our KYC partner's portal for further verification. {% openapi src="" path="/customers" method="post" %} [offblocks-api-spec\_master\_api.yaml](https://1545901005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTToCQFhAYRMgObGgbSjC%2Fuploads%2FV89o79d3urx40FHQswwW%2Foffblocks-api-spec_master_api.yaml?alt=media\&token=762e0468-4f4f-407e-9281-df4ee98be768) {% endopenapi %} ### Customer Entity Updates Any internal updates to the customer entity will trigger a webhook update event. For details on how to set up and manage webhook subscriptions, please refer to [webhooks](https://docs.offblocks.xyz/developer-guides/api-integration/api-reference/webhooks "mention"). ### Blockchain Updates In order to proceed with customer verification, a challenge needs to be signed and verified (see [blockchain-updates](https://docs.offblocks.xyz/developer-guides/api-integration/blockchain-updates "mention")). ### Retrieve Customer Entities To retrieve a list of all customer entities registered for the programme, make a `GET` request to `/customers`. {% openapi src="" path="/customers" method="get" %} [offblocks-api-spec\_master\_api.yaml](https://1545901005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTToCQFhAYRMgObGgbSjC%2Fuploads%2FV89o79d3urx40FHQswwW%2Foffblocks-api-spec_master_api.yaml?alt=media\&token=762e0468-4f4f-407e-9281-df4ee98be768) {% endopenapi %} ### Retrieve an Individual Customer To retrieve information about an individual customer, make a `GET` request to `/customers/{customerId}` with customer ID as a path parameter. {% openapi src="" path="/customers/{customerId}" method="get" %} [offblocks-api-spec\_master\_api.yaml](https://1545901005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTToCQFhAYRMgObGgbSjC%2Fuploads%2FV89o79d3urx40FHQswwW%2Foffblocks-api-spec_master_api.yaml?alt=media\&token=762e0468-4f4f-407e-9281-df4ee98be768) {% endopenapi %} ### Deactivate a Customer To deactivate a customer, use a `PATCH` request to `/customers/{customerId}/deactivate`. This will also deactivate all associated resources, such as accounts and cards. {% openapi src="" path="/customers/{customerId}/deactivate" method="patch" %} [offblocks-api-spec\_master\_api.yaml](https://1545901005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTToCQFhAYRMgObGgbSjC%2Fuploads%2FV89o79d3urx40FHQswwW%2Foffblocks-api-spec_master_api.yaml?alt=media\&token=762e0468-4f4f-407e-9281-df4ee98be768) {% endopenapi %} ### Reactivate a Customer To reactivate a previously deactivated customer, use a `PATCH` request to `/customers/{customerId}/activate`. {% openapi src="" path="/customers/{customerId}/activate" method="patch" %} [offblocks-api-spec\_master\_api.yaml](https://1545901005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTToCQFhAYRMgObGgbSjC%2Fuploads%2FV89o79d3urx40FHQswwW%2Foffblocks-api-spec_master_api.yaml?alt=media\&token=762e0468-4f4f-407e-9281-df4ee98be768) {% endopenapi %}