# Get / Search Data Sources

Get / Search Data Sources


Endpoint: POST /v3/datasources/get
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (any)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise.

## Request fields (application/json):

  - `filters` (object)
    Allows filtering the list by different attributes

  - `filters.id` (array)
    Unique ID of the Datasource identified by MeasureOne

  - `filters.institution_display_name` (string)
    Institution name for which you want to search datasources

  - `filters.countries` (array)
    List of country a2 codes. e.g. US, CA

  - `filters.action` (string)
    Type of action for which you want to search datasources.
    Enum: "GET", "ADD_VEHICLE"

  - `filters.supports_direct_connection` (boolean)
    Filter records which has support for direct connections.

  - `filters.institution_type` (string)
    Type of institution for which you want to search datasources. 

: To search for academic institutions
: To search for employers
: To search for payroll providers
: To search for home insurance providers
: To search for auto insurance providers
: To search for renters insurance providers
: To search for brokerage firms
: To search for banks

  - `filters.ipeds_id` (string)
    IPEDS ID of the school. This attribute will be available for academic institution datasources

  - `filters.ope_id` (string)
    OPE ID of the school. This attribute will be available for academic institution datasources

  - `filters.ceeb_id` (string)
    CEEB ID of the school. This attribute will be available for academic institution datasources

  - `options` (object)

  - `options.get_logo` (boolean)
    Get datasource logo in response.

  - `options.count` (number)
    number of datasources required

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the datasource identified by MeasureOne

  - `contact_info` (object)
    Contact information of Datasource institution

  - `contact_info.website` (string)
    Web address of the datasource institution

  - `contact_info.registrar_phone` (string)
    Registrar phone_number of the school. This attribute will be available for academic institution datasources

  - `contact_info.phone_number` (string)
    Phone number of institution

  - `contact_info.it_helpdesk_email` (string)
    IT helpdesk email address of institution

  - `contact_info.it_helpdesk_phone` (string)
    IT helpdesk phone_number of institution

  - `contact_info.registrar_email` (string)
    Registrar email address of the school. This attribute will be available for academic institution datasources

  - `contact_info.addresses` (array)

  - `contact_info.addresses.addr1` (string)
    Address Line 1

  - `contact_info.addresses.addr2` (string)
    Address Line 2

  - `contact_info.addresses.country` (object)

  - `contact_info.addresses.country.name` (string)
    Name of the country

  - `contact_info.addresses.country.a2_code` (string)
    A2 code  of the country

  - `contact_info.addresses.state_name` (string)
    Name of the state

  - `contact_info.addresses.state_short_code` (string)
    Short code of the state. e.g CA, CO, NY etc.

  - `contact_info.addresses.city` (string)
    Name of the city

  - `contact_info.addresses.zipcode` (string)
    zipcode

  - `ipeds_id` (string)
    IPEDS ID of the school. This attribute will be available for academic institution datasources

  - `ceeb_id` (string)
    CEEB ID of the school. This attribute will be available for academic institution datasources

  - `ope_id` (string)
    OPE ID of the school. This attribute will be available for academic institution datasources

  - `institution_display_name` (string)
    Institution name of the Datasource

  - `student_type` (array)
    Types of students supported by this academic institution Datasource. Can be CURRENT_STUDENT, ALUMNI

  - `student_type.type` (string)
    Student type

  - `student_type.name` (string)
    Description of student type

  - `employment_type` (array)
    Types of employment supported by this Datasource. Can be EMPLOYEE, CONTRACTOR, GIG_WORKER

  - `employment_type.type` (string)
    Employment type

  - `employment_type.name` (string)
    Description of Employment type

  - `employment_status` (array)
    Employment status supported by this Datasource. Can be CURRENT, FORMER

  - `employment_status.type` (string)
    Employment status

  - `employment_status.name` (string)
    Description of Employment status

  - `logos` (array)
    Logos of institution

  - `logos.type` (string)
    Type of logo

  - `logos.uri` (string)
    URI of logo

  - `logos.base64_content` (string)
    base64-encoded logo

  - `countries` (array)
    Datasource supported country

  - `countries.a2_code` (string)
    A2 Code of the country

## Response 400 fields (application/json):

  - `data` (object)

  - `data.message` (string)
    message will be returned

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

  - `http_code` (number)
    Example: 405