---
title: "Retrieve an organization"
method: GET
path: "/organizations/{id}"
tags: ["Core resources"]
---

# Retrieve an organization

`GET /organizations/{id}`

## Request

- Base URL: `https://core.sivo.com`
- URL: `https://core.sivo.com/organizations/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://dashboard.sivo.com/oauth/authorize`
    - Client credentials
    - Token URL: `https://core.sivo.com/oauth/token`
- TypeScript: <https://skmtc.dev/sivo/apis/sivo-advance-api/docs/organizations/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: An object id with prefix

## Response `200`

Successful operation

- object
  - `name` string, required: Non-empty text string
  - `website` string: The website address of the business
  - `linkedin` string, uri: The linked-in url of the business
  - `address` object: The business address
    - `region` string: State, province, prefecture, or region component. For the US and Canada, MUST be 2-letter abbreviation.
    - `country` string, required: ISO 3166-1 alpha-2 country code
    - `formatted` string: Full mailing address, formatted for display or use on a mailing label. This field MAY contain multiple lines, separated by newlines.
    - `street_address` string: Full street address component, which MAY include house number, street name, Post Office Box, and multi-line extended street address information. This field MAY contain multiple lines, separated by newlines.
    - `locality` string: City, town, or locality component.
    - `postal_code` string: Zip code or postal code component.
  - `legal_structure` 'sole_proprietor' | 'single_member_llc' | 'limited_liability_company' | 'general_partnership' | 'unlisted_corporation' | 'publicly_traded_corporation' | 'association' | 'non_profit' | 'government_organization' | 'revocable_trust' | 'irrevocable_trust' | 'estate': The legal structure of the business
  - `industry` string: The industry of the business
  - `formation_date` string, date: The formation date of the business
  - `size` '1-24' | '25-99' | '100-499' | '500+': The size of the business based on number of employees or contractors
  - `yc_id` union: The organization's Y Combinator backing: the id from its verified YC link, or its unverified answer (no or claimed)
    - string
    - 'no' | 'claimed'
  - `aiprise_business_id` string: The AiPrise business profile id
  - `monato_business_id` string: The monato business id
  - `picture` string, uri, required: The business logo
  - `id` string, required: An object id with prefix
  - `created_at` string, date-time, required: Creation date and time
  - `created_by` string, required: ID of the user that created this object
  - `updated_at` string, date-time, required: Last update date and time
  - `updated_by` string, required: ID of the user that last updated this object

## Changes

- **2026-11-03** `4bbab9699612`: 2 warning, 3 info
  - removed the optional property `advance_for` from the response with the `200` status
  - removed the optional property `yc_verified` from the response with the `200` status
  - added the optional property `yc_id` to the response with the `200` status
  - the `created_by` response's property pattern was changed from `^[a-z]{3,7}_[0-9A-Za-z]{27}$` to `^[0-9A-Za-z_-]{1,255}$` for the status `200`
  - …1 more

[Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/organizations/:id/get.md)

---

[API](https://skmtc.dev/sivo/apis/sivo-advance-api.md) - [All operations](https://skmtc.dev/sivo/apis/sivo-advance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sivo/apis/sivo-advance-api/revisions/4bbab9699612?raw)