> ## Documentation Index > Fetch the complete documentation index at: https://docs.borderless.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Get an Identity by id > Retrieve an Identity by its unique identification. Returns 404 if the Identity does not exist. ## OpenAPI ````yaml https://sandbox-api.borderless.xyz/v1/api-json get /v1/identities/{id} openapi: 3.0.0 info: title: Borderless API description: The Borderless API documentation. version: '1.0' contact: {} servers: - url: https://sandbox-api.borderless.xyz security: [] tags: [] paths: /v1/identities/{id}: get: tags: - Identities summary: Get an Identity by id description: >- Retrieve an Identity by its unique identification. Returns 404 if the Identity does not exist. operationId: IdentitiesController_getIdentity parameters: - name: id required: true in: path schema: type: string responses: '200': description: Successfully retrieved Identity data. content: application/json: schema: $ref: '#/components/schemas/IdentityEntity' '404': description: The Identity with the specified id does not exist. security: - bearer: [] components: schemas: IdentityEntity: type: object properties: id: type: string type: allOf: - $ref: '#/components/schemas/IdentityType' deleted: type: boolean hasComplianceChecks: type: boolean data: oneOf: - $ref: '#/components/schemas/PersonalDataEntity' - $ref: '#/components/schemas/BusinessDataEntity' discriminator: propertyName: type mapping: Personal: $ref: '#/components/schemas/PersonalDataEntity' Business: $ref: '#/components/schemas/BusinessDataEntity' mastercardCredential: nullable: true type: object allOf: - $ref: '#/components/schemas/MastercardCredentialEntity' required: - id - type - deleted - hasComplianceChecks - data IdentityType: type: string enum: - Personal - Business PersonalDataEntity: type: object properties: firstName: type: string lastName: type: string secondLastName: type: string nullable: true middleName: type: string nullable: true taxId: type: string nullable: true dateOfBirth: type: string example: YYYY-MM-DD nullable: true email: type: string nullable: true phone: type: string nullable: true activity: type: string nullable: true sex: nullable: true allOf: - $ref: '#/components/schemas/Sex' address: $ref: '#/components/schemas/PostalAddressEntity' documents: type: array items: $ref: '#/components/schemas/IdentityDocumentEntity' occupationCode: nullable: true allOf: - $ref: '#/components/schemas/Occupations' employmentStatus: nullable: true allOf: - $ref: '#/components/schemas/EmploymentStatus' sourceOfFunds: nullable: true allOf: - $ref: '#/components/schemas/PersonalSourceOfFunds' accountPurpose: nullable: true allOf: - $ref: '#/components/schemas/PersonalAccountPurpose' accountPurposeOther: type: string nullable: true monthlyAmounts: nullable: true allOf: - $ref: '#/components/schemas/MonthlyAmounts' actingAsIntermediary: type: boolean citizenship: nullable: true allOf: - $ref: '#/components/schemas/CountryCode' nationalities: type: array description: >- All nationalities held by the individual. Required for EEA-resident individuals. items: $ref: '#/components/schemas/CountryCode' placeOfBirthCountry: nullable: true description: Country of birth. Required for EEA-resident individuals. allOf: - $ref: '#/components/schemas/CountryCode' placeOfBirthCity: type: string nullable: true description: >- City of birth. Recommended for EEA-resident individuals; required under EU law in 2027. hasForeignTaxRegistration: type: boolean nullable: true description: >- Whether the individual has tax registrations outside their country of residence. Required for EEA-resident individuals by 2026-12-31. required: - firstName - lastName - secondLastName - middleName - taxId - dateOfBirth - email - phone - activity - sex - address - documents - occupationCode - employmentStatus - sourceOfFunds - accountPurpose - accountPurposeOther - monthlyAmounts - actingAsIntermediary - citizenship - nationalities - placeOfBirthCountry - placeOfBirthCity - hasForeignTaxRegistration BusinessDataEntity: type: object properties: email: type: string phone: type: string nullable: true taxId: type: string businessRegistrationNumber: type: string nullable: true description: >- The country-issued business registration number (e.g. SIREN for FR, KvK for NL). Required for EEA-incorporated businesses. hasForeignTaxRegistration: type: boolean nullable: true description: >- Whether the business has tax registrations outside its incorporation country. Required for EEA-incorporated businesses by 2026-12-31. name: type: string dateOfIncorporation: type: string example: YYYY-MM-DD nullable: true description: type: string nullable: true sourceOfFunds: type: string nullable: true sourceOfFundsDescription: type: string nullable: true website: type: string nullable: true businessType: allOf: - $ref: '#/components/schemas/BusinessType' businessIndustryCode: type: string nullable: true isDao: type: boolean nullable: true hasMaterialIntermediaryOwnership: type: boolean nullable: true annualRevenue: nullable: true allOf: - $ref: '#/components/schemas/AnnualRevenue' approximateMonthlyTransaction: nullable: true allOf: - $ref: '#/components/schemas/MonthlyTransactionCount' expectedMonthlyVolumeUsd: nullable: true allOf: - $ref: '#/components/schemas/ExpectedMonthlyVolumeUsd' businessTradeName: type: string nullable: true accountPurpose: nullable: true allOf: - $ref: '#/components/schemas/BusinessAccountPurpose' accountPurposeOther: type: string nullable: true highRiskActivities: type: array items: $ref: '#/components/schemas/HighRiskActivity' operatesInProhibitedCountries: type: boolean nullable: true complianceScreeningExplanation: type: string nullable: true conductsMoneyServices: type: boolean nullable: true conductsMoneyServicesUsingBridge: type: boolean nullable: true conductsMoneyServicesDescription: type: string nullable: true ultimateBeneficialOwners: type: array items: $ref: '#/components/schemas/BeneficialOwnerEntity' address: $ref: '#/components/schemas/PostalAddressEntity' documents: type: array items: $ref: '#/components/schemas/IdentityDocumentEntity' approximateDepositFirstMonth: type: string nullable: true deprecated: true description: 'Deprecated: use `expectedMonthlyVolumeUsd` instead' required: - email - phone - taxId - businessRegistrationNumber - hasForeignTaxRegistration - name - dateOfIncorporation - description - sourceOfFunds - sourceOfFundsDescription - website - businessType - businessIndustryCode - isDao - hasMaterialIntermediaryOwnership - annualRevenue - approximateMonthlyTransaction - expectedMonthlyVolumeUsd - businessTradeName - accountPurpose - accountPurposeOther - highRiskActivities - operatesInProhibitedCountries - complianceScreeningExplanation - conductsMoneyServices - conductsMoneyServicesUsingBridge - conductsMoneyServicesDescription - ultimateBeneficialOwners - address - documents - approximateDepositFirstMonth MastercardCredentialEntity: type: object properties: status: type: string description: The status of the account alias. countryOfResidence: type: string description: Country of residence. paymentMethods: $ref: '#/components/schemas/PaymentMethodsEntity' vasps: description: Associated VASPs. type: array items: type: string assetsAndNetworks: $ref: '#/components/schemas/AssetAndNetworkPaginationEntity' required: - status Sex: type: string enum: - Male - Female PostalAddressEntity: type: object properties: id: type: string street1: type: string street2: type: string nullable: true city: type: string state: type: string nullable: true country: allOf: - $ref: '#/components/schemas/CountryCode' postalCode: type: string required: - id - street1 - street2 - city - state - country - postalCode IdentityDocumentEntity: type: object properties: id: type: string issuingCountry: allOf: - $ref: '#/components/schemas/CountryCode' type: allOf: - $ref: '#/components/schemas/IdentityDocumentType' subType: nullable: true allOf: - $ref: '#/components/schemas/IdentityDocumentSubType' idNumber: type: string nullable: true issuedDate: type: string example: YYYY-MM-DD nullable: true expiryDate: type: string example: YYYY-MM-DD nullable: true required: - id - issuingCountry - type - subType - idNumber - issuedDate - expiryDate Occupations: type: string enum: - '132011' - '272011' - '152011' - '291291' - '519191' - '113012' - '112011' - '413011' - '172011' - '131011' - '194010' - '191010' - '172021' - '452011' - '532020' - '493011' - '532010' - '512011' - '533011' - '452021' - '392021' - '339011' - '392011' - '171011' - '173011' - '119041' - '254010' - '271010' - '192010' - '272021' - '192021' - '291181' - '492097' - '493021' - '493022' - '493023' - '492091' - '396010' - '333011' - '513011' - '395011' - '353011' - '433011' - '433021' - '172031' - '191020' - '194021' - '472011' - '433031' - '472020' - '273011' - '274010' - '434011' - '132031' - '493031' - '131199' - '513020' - '131021' - '517011' - '292031' - '435011' - '472031' - '472040' - '412010' - '472050' - '351011' - '172041' - '519010' - '194031' - '192030' - '111011' - '211021' - '399011' - '291011' - '172051' - '131030' - '537061' - '212011' - '193033' - '292010' - '272022' - '499091' - '271021' - '499092' - '432099' - '113111' - '131141' - '131041' - '151221' - '113021' - '172061' - '151241' - '519160' - '151299' - '151251' - '151230' - '151211' - '492011' - '191030' - '474011' - '472070' - '472061' - '119021' - '499010' - 5370XX - '352010' - '333012' - '434021' - '131051' - '211019' - '412021' - '435021' - '273092' - '434031' - '537021' - '132041' - '434041' - '132070' - '339091' - '519020' - '434051' - '519030' - '514031' - '272030' - '439021' - 15124X - '519080' - '319091' - '291292' - '291020' - '475010' - '439031' - '333021' - '292032' - 29205X - '291031' - '359011' - '212021' - '272091' - '359021' - '435032' - '419091' - '533030' - '472080' - '475023' - '193011' - '273041' - '119030' - '211012' - '492092' - '173023' - '172070' - '492093' - 49209X - '499051' - '512020' - '472111' - '492096' - '252020' - '474021' - '434061' - 3940XX - '119161' - '292042' - '291214' - '512031' - '172199' - '272099' - '119070' - '172081' - '194040' - '192041' - '519194' - '475022' - '436011' - '291128' - '399031' - '475032' - '519041' - '113013' - '119013' - '271022' - '353023' - '474031' - '434071' - '132051' - '433099' - '132061' - '113031' - '332020' - '332011' - '552010' - '471011' - '331011' - '451011' - '331021' - '351012' - '371011' - '371012' - '491011' - '411012' - '431011' - '331012' - '511011' - '331099' - '411011' - '331091' - '333031' - '453031' - '532031' - '271023' - '513091' - '513092' - '513093' - '359099' - '352021' - '513099' - '353041' - '119051' - '454011' - '514020' - '131131' - '119171' - '519051' - '517021' - '433041' - '393010' - '111021' - 19204X - '472121' - '452041' - '271024' - '514033' - '395012' - '474041' - '291299' - '211022' - '499021' - '493040' - '499098' - '519198' - '473010' - '474051' - '499031' - '311121' - '359031' - '434081' - '434161' - '113121' - '131070' - 49904X - '172110' - '113051' - '537051' - '434199' - '151212' - '519061' - '472130' - '439041' - '413021' - '132053' - '271025' - '273091' - '434111' - 37201X - '519071' - '231020' - '231012' - '537062' - '171012' - '373011' - '516011' - '231011' - '436012' - '232099' - '111031' - '254022' - '434121' - '254031' - '292061' - '191099' - '434131' - '499094' - '534010' - '119081' - '454020' - '131081' - '537063' - '514041' - '292035' - '372012' - '439051' - '499071' - '499043' - '131111' - '119199' - '395092' - '499095' - '172121' - '131161' - '112021' - '211013' - '319011' - '172131' - '152021' - '172141' - '274099' - '273099' - '119111' - '319092' - '292072' - '191040' - '436013' - '319094' - '131121' - '211023' - '211014' - '271026' - '514050' - '435041' - '553010' - '551010' - '554010' - '499044' - '172151' - '452090' - '474090' - '292090' - '518090' - '193090' - '493090' - '514060' - '419010' - '514070' - '519195' - '394031' - '533099' - '272041' - '272042' - '119121' - '151244' - '434141' - '273023' - '172161' - 29203X - '194051' - '291151' - '291161' - '291171' - '311131' - '195010' - '291122' - '312010' - '439199' - '439061' - '439071' - '152031' - '292081' - '291041' - '434151' - 31113X - 5120XX - 21109X - 27102X - 17301X - 2590XX - 17302X - 3930XX - 4750XX - 1320XX - 37301X - '299000' - 31909X - 49909X - 1940XX - 51403X - 5371XX - 1520XX - 514XXX - 39509X - 2912XX - 51919X - 5191XX - 33909X - 19303X - 5340XX - 2530XX - 51609X - 5360XX - 5170XX - '519111' - '537064' - '472140' - '519120' - '519196' - '232011' - '292043' - '536021' - '333041' - '412022' - '536061' - '433051' - '399099' - '132052' - '119179' - '372021' - '172171' - '291051' - '319095' - '292052' - '319097' - '274021' - '519151' - '192099' - '291123' - '312020' - '291071' - '472151' - '472161' - '472152' - '291081' - '333050' - '435051' - '435052' - '435053' - '119131' - '251000' - '518010' - '499060' - '515111' - '252010' - '516021' - '515113' - '515112' - '339021' - '211092' - '433061' - '272012' - '435061' - '131082' - '439081' - '132020' - '119141' - '292053' - '112030' - '273031' - '435031' - '537070' - '131023' - '113061' - '291124' - '492020' - '292034' - '291224' - '474061' - '534031' - '419020' - '434171' - '399032' - '291125' - '537081' - '291141' - '211015' - '472171' - '212099' - '434181' - '399041' - '291126' - '412031' - '499096' - '472181' - '475071' - '535011' - '419099' - '419031' - '112022' - '413091' - '414010' - '517041' - '533051' - '339094' - '193034' - '252030' - '436014' - '413031' - '492098' - '339030' - '474071' - '516031' - '472211' - '535020' - '535031' - '435071' - '516040' - '533053' - '395094' - '493050' - '119151' - '211093' - '194061' - '211029' - '193041' - '151252' - '151253' - '472231' - '252050' - '291127' - '518021' - '439111' - '152041' - '537065' - '472221' - '512041' - '211011' - '391000' - '531000' - '291240' - '292055' - '193022' - '173031' - '171020' - '432011' - '516050' - '132081' - '132082' - '533054' - '259040' - '273042' - '499052' - '419041' - '432021' - '274030' - '433071' - '516060' - '291129' - '519197' - '232093' - '514111' - '397010' - '113131' - '131151' - '533052' - '536051' - '339093' - '536030' - '113071' - '413041' - '373013' - '253041' - '272023' - '475040' - '999999' - '516093' - '193051' - '393031' - '291131' - '319096' - '292056' - '353031' - '518031' - '151255' - '151254' - '435111' - '514120' - '131022' - '499081' - '517042' - '439022' - '273043' EmploymentStatus: type: string enum: - Employed - Homemaker - Retired - SelfEmployed - Student - Unemployed PersonalSourceOfFunds: type: string enum: - CompanyFunds - EcommerceReseller - GamblingProceeds - Gifts - GovernmentBenefits - Inheritance - InvestmentsLoans - PensionRetirement - Salary - SaleOfAssetsRealEstate - Savings - SomeoneElsesFunds PersonalAccountPurpose: type: string enum: - CharitableDonations - EcommerceRetailPayments - InvestmentPurposes - OperatingACompany - Other - PaymentsToFriendsOrFamilyAbroad - Payroll - PersonalOrLivingExpenses - ProtectWealth - PurchaseGoodsAndServices - ReceivePaymentForFreelancing - ReceivePaymentsForGoodsAndServices - ReceiveSalary - TaxOptimization - ThirdPartyMoneyTransmission - TreasuryManagement MonthlyAmounts: type: string enum: - LessThan5K - From5KTo10K - From10KTo50K - GreaterThan50K CountryCode: type: string enum: - AF - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - CV - KH - CM - CA - KY - CF - TD - CL - CN - CX - CC - CO - KM - CD - CG - CK - CR - HR - CU - CW - CY - CZ - CI - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - MK - RO - RU - RW - RE - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - UM - US - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW - AX - ZZ BusinessType: type: string enum: - Cooperative - Corporation - Llc - Other - Partnership - SoleProp - Trust AnnualRevenue: type: string enum: - Under100K - From100KTo1M - From1MTo10M - From10MTo50M - From50MTo250M - Over250M MonthlyTransactionCount: type: string enum: - Under10 - From10To100 - From100To1000 - From1000To10000 - From10000To100000 - From100000To1M - Over1M ExpectedMonthlyVolumeUsd: type: string enum: - Under10K - From10KTo50K - From50KTo250K - From250KTo1M - From1MTo5M - From5MTo10M - Over10M BusinessAccountPurpose: type: string enum: - charitable_donations - ecommerce_retail_payments - investment_purposes - other - payments_to_friends_or_family_abroad - payroll - personal_or_living_expenses - protect_wealth - purchase_goods_and_services - receive_payments_for_goods_and_services - tax_optimization - third_party_money_transmission - treasury_management HighRiskActivity: type: string enum: - adult_entertainment - gambling - hold_client_funds - investment_services - lending_banking - marijuana_or_related_services - money_services - nicotine_tobacco_or_related_services - operate_foreign_exchange_virtual_currencies_brokerage_otc - pharmaceuticals - precious_metals_precious_stones_jewelry - safe_deposit_box_rentals - third_party_payment_processing - weapons_firearms_and_explosives - none_of_the_above BeneficialOwnerEntity: type: object properties: personalIdentityId: type: string hasOwnership: type: boolean ownershipPercentage: type: number nullable: true hasControl: type: boolean controlPersonTitle: type: string nullable: true isSigner: type: boolean isDirector: type: boolean description: >- True if this person is a director of the company. Required on every associated person of an EEA-incorporated business (Bridge MiCA/EMI). relationshipEstablishedAt: type: string example: YYYY-MM-DD nullable: true attestedOwnershipStructureAt: type: string example: YYYY-MM-DD nullable: true required: - personalIdentityId - hasOwnership - ownershipPercentage - hasControl - controlPersonTitle - isSigner - isDirector - relationshipEstablishedAt - attestedOwnershipStructureAt PaymentMethodsEntity: type: object properties: cryptoWallet: $ref: '#/components/schemas/CryptoWalletEntity' bankAccount: $ref: '#/components/schemas/BankAccountEntity' AssetAndNetworkPaginationEntity: type: object properties: offset: type: number limit: type: number count: type: number total: type: number items: type: array items: $ref: '#/components/schemas/AssetAndNetworkEntity' IdentityDocumentType: type: string enum: - Passport - DriverLicense - NationalId - ResidencePermit - Formation - Ownership - ProofOfAddress - SourceOfFunds - IndividualHolding - BVN_NG - Selfie - Aadhaar - PAN - TaxId - LetterOfAuthority - EvidenceOfGoodStanding - ProofOfNatureOfBusiness - Other IdentityDocumentSubType: type: string enum: - UtilityBill - BankStatement - RentalAgreement - TaxDocument - GovernmentCorrespondence CryptoWalletEntity: type: object properties: cryptoSupportedAssets: type: array items: type: string BankAccountEntity: type: object properties: bankSupportedCurrencies: type: array items: type: string AssetAndNetworkEntity: type: object properties: asset: type: string network: type: string supportedVasps: type: array items: type: string securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````