---
title: "Retrieve organisation details."
method: GET
path: "/Leads/{leadId}/organisationdetails"
tags: ["GET Details"]
---

# Retrieve organisation details.

`GET /Leads/{leadId}/organisationdetails`

## Request

- Base URL: `https://partners.staging-youlendapi.com/onboarding`
- URL: `https://partners.staging-youlendapi.com/onboarding/Leads/{leadId}/organisationdetails`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

## Path parameters

- `leadId` string, uuid, required

## Headers

- `api-version` string

## Response `200`

OK

- OrganisationDetailsStepView: A model containing data about organisations details step for a lead.
  - `leadId` string, uuid: Gets or sets the lead id.
  - `preApprovalId` string, uuid
  - `organisationDetails` OrganisationDetails: Model for the organisation details for a loead.
    - `leadId` string, uuid: Gets or sets the lead id.
    - `companyName` string, nullable: Gets or sets the company name.
    - `tradingName` string, nullable: Gets or sets the trading name.
    - `companyNumber` string, nullable: Gets or sets the company number.
    - `vatNumber` string, nullable: Gets or sets the VAT number for the organisation.
    - `formationDate` string, date-time: Gets or sets the formation date for the organisation.
    - `companyType` string, nullable: Gets or sets the key merchant company type.
    - `address` Address
      - `addressLine1` string, nullable
      - `addressLine2` string, nullable
      - `addressLine3` string, nullable
      - `city` string, nullable
      - `region` string, nullable
      - `postcode` string, nullable
      - `country` string, nullable
    - `country` string, nullable: Gets or sets the country ISO code for the organisation.
    - `description` string, nullable: Gets or sets the description for the company.
    - `keyContactName` string, nullable: Gets or sets the key merchant contact who will be setting up the loan.
    - `website` string, nullable: Gets or sets the organisation website URL.
    - `phoneNumber` string, nullable: Gets or sets the organisation phone number.
    - `email` string, nullable: Gets or sets the organisation email address.
    - `significantPersons` SignificantPerson[], nullable: Gets or sets the list of significant persons.
      - `personId` string, uuid
      - `firstName` string, nullable
      - `surname` string, nullable
      - `typeOfPerson` string, nullable
      - `address` Address
        - `addressLine1` string, nullable
        - `addressLine2` string, nullable
        - `addressLine3` string, nullable
        - `city` string, nullable
        - `region` string, nullable
        - `postcode` string, nullable
        - `country` string, nullable
      - `dateOfBirth` string, date-time, nullable
      - `percentageOwned` number, double
      - `email` string, nullable
      - `mobileNumber` string, nullable
      - `nationality` string, nullable
      - `niNumber` string, nullable
      - `socialSecurityNumber` string, nullable
      - `placeOfBirth` string, nullable
    - `industries` Industry[], nullable: Gets or sets the list of industries in which the organisation conducts business.
      - `code` string, required: Gets or sets the SIC code for the industry.
      - `description` string, required: Gets or sets the description of the industry.
    - `confirmedCreditSearch` boolean: Gets or sets a value indicating whether the organisation consents to a credit search.
    - `employerIdentificationNumber` string, nullable: Gets or sets the merchants tax identification number (required for USA).

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/youlend/apis/onboarding.md) - [All operations](https://skmtc.dev/youlend/apis/onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/onboarding/revisions/32aa9c8d752a?raw)