# Retrieve a project

No specific scope required.

Endpoint: GET /projects/{id}
Version: v1
Security: http, oauth2

## Path parameters:

  - `id` (string, required)

## Query parameters:

  - `find_by` (string)
    The field to search by
    Enum: "id", "external_id", "shortcode"

  - `origin` (string)
    Used if find_by=external_id by default it will use the integration slug

  - `include` (string)
    Available includes are client, client.primaryContact. You can include multiple options by separating them with a comma.

## Response 200 fields (application/json):

  - `id` (string, required)

  - `external_id` (string,null, required)
    Can be used to add an identifier to the project from an external system, must be unique

  - `external_origin` (string,null, required)
    If originated from external system origin is added

  - `title` (string, required)

  - `shortcode` (string, required)

  - `po_number` (string,null, required)

  - `project_type` (object, required)

  - `project_type.color` (string, required)

  - `project_type.order` (integer, required)

  - `project_type.is_default` (boolean, required)

  - `status` (string, required)

  - `is_acquisition` (boolean, required)

  - `is_private` (boolean, required)

  - `start_date` (string,null, required)

  - `end_date` (string,null, required)

  - `client` (object, required)

  - `client.external_id` (string,null, required)
    Can be used to add an identifier to the client from an external system, must be unique

  - `client.name` (string, required)

  - `client.primary_contact` (any, required)

  - `client.origin_space` (any, required)

  - `tags` (array)

  - `custom_fields` (object, required)
    The key is the field name for your custom field, value type depends on the field type

  - `team` (array)
    Project team

  - `team.first_name` (string, required)

  - `team.last_name` (string, required)

  - `team.email` (string, required)

  - `team.type` (string, required)
    Enum: "user", "guest", "tax_advisor", "integration"

  - `team.added_at` (string, required)

  - `team.space` (object, required)

  - `guests` (array)
    Project guests

  - `computed_fields` (object)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 404 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.