> ## Documentation Index > Fetch the complete documentation index at: https://docs.nuvera.global/llms.txt > Use this file to discover all available pages before exploring further. # List customers > List all customers for the authenticated organization with cursor-based pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/customers openapi: 3.1.0 info: title: Nuvera API description: Nuvera Payment Platform REST API version: '1.0' contact: {} servers: - url: http://localhost:45000 security: [] tags: [] paths: /api/v1/customers: get: tags: - Customers summary: List customers description: >- List all customers for the authenticated organization with cursor-based pagination. operationId: CustomerController_list parameters: - name: status required: false in: query schema: type: string enum: - DRAFT - PENDING_REVIEW - CORRECTION_REQUESTED - APPROVED - REJECTED - SUSPENDED - name: cursor required: false in: query schema: type: string - name: limit required: false in: query schema: minimum: 1 maximum: 100 default: 20 type: integer responses: default: description: '' content: application/json: schema: $ref: '#/components/schemas/CustomerListOutputDto_Output' security: - x-api-key: [] signed-request: [] components: schemas: CustomerListOutputDto_Output: type: object properties: items: type: array items: type: object properties: id: type: string orgId: type: string companyName: type: string registrationNumber: type: string countryOfIncorporationId: anyOf: - type: string - type: 'null' countryOfIncorporation: anyOf: - type: object properties: alpha2: type: string name: type: string required: - alpha2 - name additionalProperties: false - type: 'null' tradingNames: anyOf: - type: string - type: 'null' businessIndustryId: anyOf: - type: string - type: 'null' businessIndustry: anyOf: - type: object properties: code: type: string name: type: string required: - code - name additionalProperties: false - type: 'null' website: anyOf: - type: string - type: 'null' operationalChannels: anyOf: - type: string - type: 'null' businessEmail: anyOf: - type: string - type: 'null' primaryContactFirstName: anyOf: - type: string - type: 'null' primaryContactLastName: anyOf: - type: string - type: 'null' primaryContactPhone: anyOf: - type: string - type: 'null' primaryContactEmail: anyOf: - type: string - type: 'null' primaryContactIsAssociate: anyOf: - type: boolean - type: 'null' businessType: anyOf: - type: string - type: 'null' formationDate: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' addressLine1: anyOf: - type: string - type: 'null' addressLine2: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' stateProvinceRegion: anyOf: - type: string - type: 'null' postalCode: anyOf: - type: string - type: 'null' addressCountryId: anyOf: - type: string - type: 'null' addressCountry: anyOf: - type: object properties: alpha2: type: string name: type: string required: - alpha2 - name additionalProperties: false - type: 'null' estimatedAnnualRevenueUsd: anyOf: - type: string - type: 'null' expectedMonthlyPaymentsUsd: type: string primaryBusinessPurpose: anyOf: - type: string - type: 'null' sourceOfFunds: anyOf: - type: string - type: 'null' taxIdType: anyOf: - type: string - type: 'null' taxIdentificationNumber: anyOf: - type: string - type: 'null' operatesInProhibitedCountries: anyOf: - type: boolean - type: 'null' highRiskActivities: anyOf: - type: array items: type: string - type: 'null' transmitsCustomerFunds: anyOf: - type: boolean - type: 'null' customerFundsDescription: anyOf: - type: string - type: 'null' conductsMoneyServices: anyOf: - type: boolean - type: 'null' primaryPurposeOther: anyOf: - type: string - type: 'null' ownershipIndirectOrOffshoreStructures: anyOf: - type: string - type: 'null' ownershipTrustsFundsOrHoldingCompanies: anyOf: - type: boolean - type: 'null' ownershipBranchesOrSubsidiaries: anyOf: - type: boolean - type: 'null' ownershipBranchesOrSubsidiariesDetails: anyOf: - type: string - type: 'null' businessModelDescription: anyOf: - type: string - type: 'null' customerType: anyOf: - type: string - type: 'null' invoiceIssuance: anyOf: - type: string - type: 'null' productServiceCatalogueWithPrices: anyOf: - type: boolean - type: 'null' mainCustomers: anyOf: - type: string - type: 'null' mainSuppliers: anyOf: - type: string - type: 'null' completeFlowOfFunds: anyOf: - type: string - type: 'null' significantCashVolumes: anyOf: - type: boolean - type: 'null' holdsClientBalances: anyOf: - type: boolean - type: 'null' receivesUnrelatedThirdPartyPayments: anyOf: - type: boolean - type: 'null' primaryOperatingCurrency: anyOf: - type: string - type: 'null' fxConversion: anyOf: - type: boolean - type: 'null' fxConversionDescription: anyOf: - type: string - type: 'null' endCustomersIdentified: anyOf: - type: string - type: 'null' countriesWhereOperatesOrCustomers: anyOf: - type: string - type: 'null' averageTransactionAmountUsd: anyOf: - type: string - type: 'null' geographicDistribution: anyOf: - type: string - type: 'null' registeredPaidInCapitalUsd: anyOf: - type: string - type: 'null' lastFinancialStatementsClosingDate: anyOf: - type: string - type: 'null' lastFinancialStatementsAudited: anyOf: - type: boolean - type: 'null' virtualAccountPurpose: anyOf: - type: array items: type: string - type: 'null' virtualAccountPurposeOther: anyOf: - type: string - type: 'null' virtualAccountBalanceUsage: anyOf: - type: string - type: 'null' virtualAccountUseContext: anyOf: - type: string - type: 'null' fatfHighRiskExposure: anyOf: - type: string - type: 'null' sanctionsExposure: anyOf: - type: string - type: 'null' regulatedInAnyJurisdiction: anyOf: - type: boolean - type: 'null' regulatedJurisdictionDetails: anyOf: - type: string - type: 'null' amlCftObligatedEntity: anyOf: - type: string - type: 'null' formalAmlCftProgramme: anyOf: - type: string - type: 'null' priorSanctionsInvestigations: anyOf: - type: boolean - type: 'null' priorSanctionsInvestigationsDetails: anyOf: - type: string - type: 'null' bankingPspRelationships: anyOf: - type: string - type: 'null' pepDeclarationStatus: anyOf: - type: string - type: 'null' pepDeclarationDetails: anyOf: - type: string - type: 'null' pepAttestationSignerName: anyOf: - type: string - type: 'null' pepAttestationDocumentNumber: anyOf: - type: string - type: 'null' pepAttestationSignerTitle: anyOf: - type: string - type: 'null' pepAttestationCompanyName: anyOf: - type: string - type: 'null' pepDeclarationAttested: anyOf: - type: boolean - type: 'null' status: type: string currentStep: type: number createdAt: type: string updatedAt: type: string beneficiaryCount: type: number paymentCount: type: number persons: type: array items: type: object properties: id: type: string customerId: type: string firstName: type: string lastName: type: string roles: type: array items: type: string ownershipPercent: anyOf: - type: number - type: 'null' nationalityId: anyOf: - type: string - type: 'null' dateOfBirth: type: string email: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' addressLine1: anyOf: - type: string - type: 'null' addressLine2: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' stateProvinceRegion: anyOf: - type: string - type: 'null' postalCode: anyOf: - type: string - type: 'null' addressCountryId: anyOf: - type: string - type: 'null' taxIdentificationNumber: anyOf: - type: string - type: 'null' taxResidenceCountryId: anyOf: - type: string - type: 'null' businessTitle: anyOf: - type: string - type: 'null' relationshipEstablishedAt: anyOf: - type: string - type: 'null' idNumber: anyOf: - type: string - type: 'null' createdAt: type: string updatedAt: type: string required: - id - customerId - firstName - lastName - roles - ownershipPercent - nationalityId - dateOfBirth - email - phone - addressLine1 - addressLine2 - city - stateProvinceRegion - postalCode - addressCountryId - taxIdentificationNumber - taxResidenceCountryId - businessTitle - relationshipEstablishedAt - idNumber - createdAt - updatedAt additionalProperties: false legalEntityShareholders: type: array items: type: object properties: id: type: string customerId: type: string companyLegalName: type: string registrationNumber: type: string countryOfIncorporationId: type: string countryOfIncorporation: anyOf: - type: object properties: alpha2: type: string name: type: string required: - alpha2 - name additionalProperties: false - type: 'null' entityType: type: string roles: type: array items: type: string ownershipPercent: type: number createdAt: type: string updatedAt: type: string required: - id - customerId - companyLegalName - registrationNumber - countryOfIncorporationId - entityType - roles - ownershipPercent - createdAt - updatedAt additionalProperties: false required: - id - orgId - companyName - registrationNumber - countryOfIncorporationId - tradingNames - businessIndustryId - website - operationalChannels - businessEmail - primaryContactFirstName - primaryContactLastName - primaryContactPhone - primaryContactEmail - primaryContactIsAssociate - businessType - formationDate - phone - addressLine1 - addressLine2 - city - stateProvinceRegion - postalCode - addressCountryId - estimatedAnnualRevenueUsd - expectedMonthlyPaymentsUsd - primaryBusinessPurpose - sourceOfFunds - taxIdType - taxIdentificationNumber - operatesInProhibitedCountries - highRiskActivities - transmitsCustomerFunds - customerFundsDescription - conductsMoneyServices - primaryPurposeOther - ownershipIndirectOrOffshoreStructures - ownershipTrustsFundsOrHoldingCompanies - ownershipBranchesOrSubsidiaries - ownershipBranchesOrSubsidiariesDetails - businessModelDescription - customerType - invoiceIssuance - productServiceCatalogueWithPrices - mainCustomers - mainSuppliers - completeFlowOfFunds - significantCashVolumes - holdsClientBalances - receivesUnrelatedThirdPartyPayments - primaryOperatingCurrency - fxConversion - fxConversionDescription - endCustomersIdentified - countriesWhereOperatesOrCustomers - averageTransactionAmountUsd - geographicDistribution - registeredPaidInCapitalUsd - lastFinancialStatementsClosingDate - lastFinancialStatementsAudited - virtualAccountPurpose - virtualAccountPurposeOther - virtualAccountBalanceUsage - virtualAccountUseContext - fatfHighRiskExposure - sanctionsExposure - regulatedInAnyJurisdiction - regulatedJurisdictionDetails - amlCftObligatedEntity - formalAmlCftProgramme - priorSanctionsInvestigations - priorSanctionsInvestigationsDetails - bankingPspRelationships - pepDeclarationStatus - pepDeclarationDetails - pepAttestationSignerName - pepAttestationDocumentNumber - pepAttestationSignerTitle - pepAttestationCompanyName - pepDeclarationAttested - status - currentStep - createdAt - updatedAt additionalProperties: false nextCursor: anyOf: - type: string - type: 'null' hasMore: type: boolean required: - items - nextCursor - hasMore additionalProperties: false securitySchemes: x-api-key: type: apiKey in: header name: x-api-key description: Nuvera API application secret key signed-request: scheme: bearer bearerFormat: JWT type: http description: RS256 per-request signed JWT ````