# Retrieve an organization

Retrieves an organization with a specified ID.

Endpoint: GET /organizations/{id}
Version: latest
Security: SecretApiKey, JWT

## Path parameters:

  - `id` (string, required)
    ID of the resource.

## Response 200 fields (application/json):

  - `id` (string)
    Unique organization identifier.
An organization is an entity that represents a company.
For more information, see [Obtain an organization ID](https://www.rebilly.com/docs/settings/organizations-and-websites/#obtain-your-organization-id-and-website-id).
    Example: "org_0YVDM8RC7GDADADSBSMW124JA8"

  - `name` (string, required)
    Name of the organization.

  - `address` (string,null)
    Street address of the organization.

  - `address2` (string,null)
    Second line of the street address.

  - `city` (string,null)
    City where the organization is located.

  - `region` (string,null)
    Region or state where the organization is located.

  - `country` (string,null, required)
    Country where the organization is located, in [ISO Alpha-2 code format](https://www.iso.org/obp/ui/#search/code/).

  - `postalCode` (string)
    Postal code of the organization.

  - `phoneNumbers` (array)
    List of phone numbers associated with the contact.

  - `phoneNumbers.label` (string, required)
    Phone number label or name.
    Example: "main"

  - `phoneNumbers.value` (string, required)
    Phone number value.
    Example: "1-512-777-0269"

  - `phoneNumbers.primary` (boolean)
    Specifies if the phone number is the contact's primary phone number.
    Example: true

  - `emails` (array)
    List of email addresses associated with the contact.

  - `emails.label` (string, required)
    Email label or name.
    Example: "main"

  - `emails.value` (string, required)
    Email address value.
    Example: "rebilly@example.com"

  - `emails.primary` (boolean)
    Specifies if the email address is the contact's primary email address.
    Example: true

  - `taxDescriptor` (string,null)
    Tax label of the organization. This information is displayed on the invoice.

  - `invoiceTimeZone` (string)
    Specifies the time zone to display on an invoice. UTC is used by default.
    Example: "America/New_York"

  - `reportCurrency` (string)
    Currency to use for conversion in reports.
This value cannot be changed.
    Example: "USD"

  - `questionnaire` (object,null)
    Organization questionnaire.

  - `questionnaire.role` (string,null)
    Role of the owner.

  - `questionnaire.monthlyTransactions` (string,null)
    Amount of monthly processed transactions.

  - `questionnaire.products` (array,null)
    List of products the organization is interested in.

  - `questionnaire.integrationType` (string,null)
    Type of integration the organization would like.

  - `questionnaire.launchTiming` (string,null)
    When the organization would like to go live.

  - `settings` (object)
    Organization settings.

  - `settings.defaultTaxCalculator` (object)
    Tax calculation settings.

  - `settings.defaultTaxCalculator.type` (string, required)
    Type of tax calculator.
    Enum: "taxjar", "avalara", "flat"

  - `settings.defaultTaxCalculator.rate` (number,null)
    Rate for flat tax calculation.

  - `settings.billing` (object,null)
    Global organization settings for billing.

  - `settings.billing.pendingOrderTtl` (string,null)
    Length of time, in ISO-8601 durations format, before which a pending order is automatically abandoned.
    Example: "P7D"

  - `settings.billing.orderDelinquencyPeriod` (string,null)
    Length of time, in ISO-8601 durations format,
which is added to the due time of the order when setting the delinquency time for all related invoices.
When the delinquency time of an invoice is reached, the order is automatically canceled.

{% admonition type="warning" %}
If the  value is , the order does not change state and remains active.
You must explicitly configure the delinquency period to enable automatic cancellation of unpaid orders.
{% /admonition %}
    Example: "P7D"

  - `settings.billing.subtractRecurringDiscountsFromMrr` (boolean)
    Specifies whether recurring discounts should be subtracted from MRR in metrics calculation.
If this value is , recurring discounts are excluded from MRR.
    Example: true

  - `settings.billing.subtractOneTimeDiscountsFromMrr` (boolean)
    Specifies whether one-time discounts should be subtracted from MRR in metrics calculation.
If this value is , one-time discounts are excluded from MRR.
    Example: true

  - `settings.taxLocations` (array)
    Additional organization addresses where a merchant may want to collect taxes using the  tax calculator.

Available only for US-based organizations.

  - `settings.taxLocations.address` (string,null)
    Street address of the tax location.

  - `settings.taxLocations.city` (string,null)
    City of the tax location.

  - `settings.taxLocations.region` (string,null)
    Region or state of the tax location.

  - `settings.taxLocations.country` (string, required)
    Country of the tax location, in [ISO Alpha-2 code format](https://www.iso.org/obp/ui/#search/code/).

  - `settings.taxLocations.postalCode` (string,null)
    Postal code of the tax location.

  - `settings.notifications` (object)
    Organization access-related notification settings.

  - `settings.notifications.notifyOnUserAccessChanges` (boolean)
    Specifies whether to send notifications when users are created or updated.

  - `settings.notifications.notifyOnApiKeyAccessChanges` (boolean)
    Specifies whether to send notifications when API keys are created or updated.

  - `settings.notifications.notificationEmailAddresses` (array)
    List of email addresses to send notifications to.

  - `taxNumbers` (array,null)
    Tax numbers of the organization.

  - `taxNumbers.type` (string, required)
    Type of the tax number.
    Enum: "eu-vat", "other"

  - `taxNumbers.value` (string, required)
    Value of the tax number.
    Example: "GB980780684"

  - `taxNumbers.isDefault` (boolean)
    Determines if the tax number is selected as default to display on invoices.
    Example: true

  - `taxNumbers.isValid` (boolean,null)
    Determines if the tax number passed the EU official [VIES validation](https://ec.europa.eu/taxation_customs/vies/#/vat-validation).
    Example: true

  - `features` (array)
    Organization features.

  - `features.name` (string)
    Name of the feature.

  - `features.description` (string)
    Description of the feature.

  - `createdTime` (string)
    Date and time which is set automatically when the resource is created.

  - `updatedTime` (string)
    Date and time which updates automatically when the resource is updated.

  - `_links` (array)
    Related links.

  - `_links.href` (string)
    Link URL.

  - `_links.rel` (string)
    Type of link.
    Enum: "self", "attachments"

## Response 401 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.

## Response 403 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.

## Response 404 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.