---
title: "GET /udl/organizationdetails/findBySource"
method: GET
path: "/udl/organizationdetails/findBySource"
tags: ["Supporting Data"]
---

# GET /udl/organizationdetails/findBySource

`GET /udl/organizationdetails/findBySource`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/organizationdetails/findBySource`
- Auth: none declared

Service operation to get a single OrganizationDetails by a source passed as a query parameter. OrganizationDetails represent details of organizations such as a corporation, manufacturer, consortium, government, etc. An organization can have detail records from several sources.

## Query parameters

- `source` string, required
- `name` string, required
- `firstResult` integer
- `maxResults` integer

## Response `200`

OK

- OrganizationDetailsAbridged[]
  - `id` string: Unique identifier of the record, auto-generated by the system.
  - `idOrganization` string, required: Unique identifier of the parent organization.
  - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format.
  - `name` string, required: Organization details name.
  - `email` string: Listed contact email address for the organization.
  - `address1` string: Street number of the organization.
  - `address2` string: Field for additional organization address information such as PO Box and unit number.
  - `address3` string: Contains the third line of address information for an organization.
  - `geoAdminLevel1` string: Administrative boundaries of the first sub-national level. Level 1 is simply the largest demarcation under whatever demarcation criteria has been determined by the governing body. For example, this may be a state or province.
  - `geoAdminLevel2` string: Administrative boundaries of the second sub-national level. Level 2 is simply the second largest demarcation under whatever demarcation criteria has been determined by the governing body. For example, this may be a county or district.
  - `geoAdminLevel3` string: Administrative boundaries of the third sub-national level. Level 3 is simply the third largest demarcation under whatever demarcation criteria has been determined by the governing body. For example, this may be a city or township.
  - `postalCode` string: A postal code, such as PIN or ZIP Code, is a series of letters or digits or both included in the postal address of the organization.
  - `description` string: Organization description.
  - `formerOrgId` string: Former organization ID (if this organization previously existed as another organization).
  - `parentOrgId` string: Parent organization ID of this organization if it is a child organization.
  - `financialYearEndDate` string, date-time: For organizations of type CORPORATION, the effective financial year end date for revenue, EBITDA, and profit values.
  - `revenue` number, double: For organizations of type CORPORATION, total annual revenue as of financialYearEndDate in US Dollars.
  - `profit` number, double: For organizations of type CORPORATION, total annual profit as of financialYearEndDate in US Dollars.
  - `ebitda` number, double: For organizations of type CORPORATION, the company EBITDA value as of financialYearEndDate in US Dollars.
  - `ftes` integer: Total number of FTEs in this organization.
  - `broker` string: Designated broker for this organization.
  - `ceo` string: For organizations of type CORPORATION, the name of the Chief Executive Officer.
  - `cfo` string: For organizations of type CORPORATION, the name of the Chief Financial Officer.
  - `cto` string: For organizations of type CORPORATION, the name of the Chief Technology Officer.
  - `riskManager` string: The name of the risk manager for the organization.
  - `massRanking` integer: Mass ranking for this organization.
  - `revenueRanking` integer: Revenue ranking for this organization.
  - `financialNotes` string: For organizations of type CORPORATION, notes on company financials.
  - `servicesNotes` string: Notes on the services provided by the organization.
  - `fleetPlanNotes` string: Satellite fleet planning notes for this organization.
  - `source` string, required: Source of the data.
  - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.
  - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets.
  - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system.
  - `createdBy` string: Application user who created the row in the database, auto-populated by the system.
  - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system.

## Other responses

- `400`: Bad Request
- `401`: Invalid/Missing User Credentials
- `403`: User Is Not Authorized
- `405`: Method Not Allowed
- `406`: MediaType Not Accepted by Request Headers
- `429`: Rate of Requests Exceeds Allowed Limit
- `500`: Internal Server Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-05-29** `4e1cbc17e814`: 2 info
  - added the new optional `query` request parameter `firstResult`
  - added the new optional `query` request parameter `maxResults`
- **2025-04-16** `75f764c843a9`: 2 info
  - api operation id `findBySource_1` removed and replaced with ``
  - the endpoint scheme security `BasicAuth` was removed from the API

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/organizationdetails/findBySource/get.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)
