> ## Documentation Index > Fetch the complete documentation index at: https://docs.moflay.com/llms.txt > Use this file to discover all available pages before exploring further. # Delete a customer > Delete a customer by their ID in the organization **Permissions**: `customers.write` ## OpenAPI ````yaml https://api.moflay.com/openapi delete /v1/customers/{id} openapi: 3.1.0 info: title: Moflay API description: The fastest way to add M-Pesa payments. version: 1.0.0 contact: name: Moflay Support email: support@moflay.com url: https://moflay.com termsOfService: https://moflay.com/legal/terms-of-service servers: - url: https://api.moflay.com description: Production server security: - token: [] tags: - name: Customers description: Create and manage customers in the organization - name: Transactions description: Everything about transactions in the organization - name: Express description: >- Create M-Pesa Express payments. Use the returned paymentId with the Payments API to read status. - name: Payments description: >- Track payment lifecycle and status for paymentIds returned by Express payment creation. externalDocs: url: https://moflay.com/docs description: Moflay Documentation paths: /v1/customers/{id}: delete: tags: - Customers summary: Delete a customer description: |- Delete a customer by their ID in the organization **Permissions**: `customers.write` operationId: delete parameters: - schema: allOf: - $ref: '#/components/schemas/CustomerId' - description: Unique identifier for the customer, prefixed with 'cus_'. required: true description: Unique identifier for the customer, prefixed with 'cus_'. name: id in: path responses: '200': description: Customer deleted successfully content: application/json: schema: $ref: '#/components/schemas/CustomerDeleteResponse' '401': description: Missing API Key Error content: application/json: schema: $ref: '#/components/schemas/MissingApiKeyError' '403': description: Invalid API Key Error content: application/json: schema: $ref: '#/components/schemas/InvalidApiKeyError' '404': description: Customer Not Found content: application/json: schema: $ref: '#/components/schemas/NotFoundError' '405': description: Method Not Allowed Error content: application/json: schema: $ref: '#/components/schemas/MethodNotAllowedError' '422': description: The validation error(s) or invalid access error content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/InvalidAccessError' description: The validation error(s) or invalid access error '429': description: Rate Limit Exceeded Error content: application/json: schema: $ref: '#/components/schemas/RateLimitExceededError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerError' security: - token: [] components: schemas: CustomerId: type: - string - 'null' maxLength: 255 example: cus_GqfKXLmg61LURZhB description: Unique identifier for the customer, prefixed with 'cus_' CustomerDeleteResponse: type: object properties: id: allOf: - $ref: '#/components/schemas/CustomerId' - description: Unique identifier for the customer, prefixed with 'cus_'. required: - id example: id: cus_GqfKXLmg61LURZhB description: Customer deleted successfully MissingApiKeyError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 401 code: type: string description: Machine-readable error name example: missing_api_key message: type: string x-speakeasy-error-message: true description: Human-readable error message example: Missing API key in the authorization header. required: - status - code - message required: - error description: Missing API Key Error InvalidApiKeyError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 403 code: type: string description: Machine-readable error name example: invalid_api_key message: type: string x-speakeasy-error-message: true description: Human-readable error message example: API key is invalid. required: - status - code - message required: - error description: Invalid API Key Error NotFoundError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 404 code: type: string description: Machine-readable error name example: not_found message: type: string x-speakeasy-error-message: true description: Human-readable error message example: The requested endpoint does not exist. required: - status - code - message required: - error description: Customer Not Found MethodNotAllowedError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 405 code: type: string description: Machine-readable error name example: method_not_allowed message: type: string x-speakeasy-error-message: true description: Human-readable error message example: Method is not allowed for the requested path. required: - status - code - message required: - error description: Method Not Allowed Error ValidationError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 422 code: type: string description: Machine-readable error name example: validation_error message: type: string x-speakeasy-error-message: true description: Human-readable error message example: We found an error with one or more fields in the request. validation: type: array items: type: object properties: field: type: string description: The name of the field that failed validation example: email message: type: string description: The validation error message for the field example: Invalid email format required: - field - message description: List of field-specific validation issues example: - field: email message: Invalid email format - field: age message: Expected number, received string required: - status - code - message - validation required: - error InvalidAccessError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 422 required: - status code: type: string description: Machine-readable error name example: invalid_access message: type: string x-speakeasy-error-message: true description: Human-readable error message example: >- The API key does not have the necessary permissions to access this resource. required: - error - code - message RateLimitExceededError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 429 code: type: string description: Machine-readable error name example: rate_limit_exceeded message: type: string x-speakeasy-error-message: true description: Human-readable error message example: You have exceeded your request limit. Please try again later. required: - status - code - message required: - error description: Rate Limit Exceeded Error InternalServerError: type: object properties: error: type: object properties: status: type: number description: HTTP status code of the error example: 500 code: type: string description: Machine-readable error name example: internal_server_error message: type: string x-speakeasy-error-message: true description: Human-readable error message example: An unexpected error occurred. required: - status - code - message required: - error description: Internal Server Error securitySchemes: token: type: http scheme: bearer description: The API key to use for authentication x-speakeasy-example: MOFLAY_API_KEY ````