> ## Documentation Index > Fetch the complete documentation index at: https://docs.blips.network/llms.txt > Use this file to discover all available pages before exploring further. # Get customer detail > Read one customer detail record for your authenticated platform. `ppvAddress` is current-state readback only and remains null until a customer payment address is explicitly issued. ## OpenAPI ````yaml /openapi/blips-public-reference.yaml get /customers/{customerId} openapi: 3.1.0 info: title: BLIPS Public Reference API version: '2026-04-08' description: >- Public OpenAPI 3.1 subset for the first BLIPS Mintlify API Reference and Playground release. This document is bound to the confirmed Public Test Backend at https://public-test.blips.network, includes only the approved first-release public endpoints, uses only internal `$ref` values, and excludes callback-only webhook documentation and operator-only surfaces. servers: - url: https://public-test.blips.network description: >- Confirmed Public Test Backend ingress target for public BLIPS API Reference, Playground, and internet-testable Try It flows. security: - BasicAuth: [] tags: - name: Platform Setup description: >- Bootstrap and platform configuration surfaces for establishing the public BLIPS integration context. - name: Sandbox API description: >- Sandbox-only externally displayed helper surfaces. These routes either adjust quote inputs or create incoming-payment review cases, but they always feed the existing quote or transaction families and never become second outward API families. - name: Tokens description: >- Platform-scoped API credential create, list, detail, and revoke operations. - name: Customers description: >- Customer onboarding, profile lifecycle, and PPV payment-address issuance surfaces. - name: Accounts description: >- Customer-bound internal-account and external-account surfaces kept in the first-layer public contract. - name: Same-Currency Transfers description: >- Same-currency receiver lookup plus incoming and outgoing transfer primitives. - name: Cross-Currency Transfers description: >- PPV-first receiver lookup, quote creation/readback, and quote execution for cross-currency flows. - name: Transactions description: Transaction readback plus bounded incoming-review decision operations. - name: Webhooks description: >- Webhook connectivity verification surface for the public BLIPS integration. paths: /customers/{customerId}: get: tags: - Customers summary: Get customer detail description: >- Read one customer detail record for your authenticated platform. `ppvAddress` is current-state readback only and remains null until a customer payment address is explicitly issued. operationId: getCustomer parameters: - $ref: '#/components/parameters/CustomerId' responses: '200': description: Customer detail returned. content: application/json: schema: $ref: '#/components/schemas/CustomerDetailMvpResponse' examples: customerDetail: summary: Customer detail with current PPV state value: id: cust_123 platformId: plat_demo_001 platformCustomerId: partner_cust_001 customerType: INDIVIDUAL fullName: Demo Customer birthDate: '1992-05-06' nationality: PH address: line1: 100 Demo Street line2: Suite 5 city: Manila state: NCR postalCode: '1000' country: PH ppvAddress: demo-customer@pay.example.blips kycStatus: APPROVED createdAt: '2026-04-05T12:00:00Z' updatedAt: '2026-04-05T12:00:00Z' '401': description: Invalid or missing API credentials. content: application/json: schema: $ref: '#/components/schemas/CustomerDetailMvpErrorResponse' examples: unauthorized: value: status: 401 code: UNAUTHORIZED message: Unauthorized details: null '404': description: Customer not found. content: application/json: schema: $ref: '#/components/schemas/CustomerDetailMvpErrorResponse' examples: notFound: value: status: 404 code: NOT_FOUND message: Customer not found details: null '410': description: Customer already deleted. content: application/json: schema: $ref: '#/components/schemas/CustomerDetailMvpErrorResponse' examples: gone: value: status: 410 code: GONE message: Customer already deleted details: null '500': description: Internal service error. content: application/json: schema: $ref: '#/components/schemas/CustomerDetailMvpErrorResponse' examples: internalError: value: status: 500 code: INTERNAL_ERROR message: Internal service error. details: null components: parameters: CustomerId: name: customerId in: path required: true description: >- System-generated customer UUID for the customer record addressed by this endpoint. schema: type: string schemas: CustomerDetailMvpResponse: type: object description: >- Public customer-detail response. `ppvAddress` is current-state readback only, uses plain `localPart@ppvDomain` form when present, and remains null until a customer payment address is explicitly issued. properties: id: type: string description: Stable customer identifier. platformId: type: string description: Platform identifier that owns this customer. platformCustomerId: type: string description: Platform-provided customer identifier stored for this customer. customerType: type: string enum: - INDIVIDUAL - ENTITY description: Customer type for this customer. fullName: type: string description: Public customer name stored for this customer. birthDate: type: string format: date nullable: true description: Customer birth date in YYYY-MM-DD format when available. nationality: type: string nullable: true description: Customer nationality or citizenship code when available. address: $ref: '#/components/schemas/CustomerAddress' nullable: true description: Customer address when available. ppvAddress: type: string nullable: true description: Public PPV address in plain `localPart@ppvDomain` format. kycStatus: type: string enum: - PENDING - APPROVED - REJECTED description: Current KYC status for the customer. createdAt: type: string format: date-time description: Creation timestamp. updatedAt: type: string format: date-time description: Last update timestamp. required: - id - platformId - platformCustomerId - customerType - fullName - ppvAddress - kycStatus - createdAt - updatedAt additionalProperties: false CustomerDetailMvpErrorResponse: type: object additionalProperties: false required: - status - code - message - details properties: status: type: integer description: HTTP status code returned for the failed customer-detail request. code: type: string description: Stable public error code for the failed customer-detail request. message: type: string description: Human-readable summary of the customer-detail failure. details: type: object nullable: true additionalProperties: true description: Additional structured error context when the request exposes one. CustomerAddress: type: object description: Customer address object. properties: line1: type: string description: Street address line for the customer. line2: type: string description: Street address line 2 when present on the customer record. city: type: string description: City for the customer address. state: type: string description: State, province, or region for the customer address. postalCode: type: string description: Postal or ZIP code for the customer address. country: type: string description: Two-letter country code or equivalent supported country value. additionalProperties: false securitySchemes: BasicAuth: type: http scheme: basic description: >- Integration-key Basic Auth (`clientId:clientSecret`) as documented in docs/public/AUTHENTICATION.md. ````