# Retrieve a Company

> Returns one Company with its descriptive metadata and Metadata Images.

`GET /companies/{id}` on `https://api.mediux.io`

## Parameters

- `id` (path, integer, required): The Company's numeric Mediux ID.

## Responses

### 200

The Company.

- `data` (object, required)
  - `kind` (string, required): One of "company".
  - `id` (integer, required)
  - `name` (string, required)
  - `description` (string, nullable, required)
  - `originCountry` (string, nullable, required)
  - `headquartersCountry` (string, nullable, required)
  - `homepage` (string, nullable, required)
  - `parentCompany` (object, nullable, required)
    - `id` (integer, required)
    - `name` (string, required)
  - `metadataImages` (object, required)
    - `logo` (object, nullable, required)
      - `id` (string (uuid), required): Stable image ID, a lowercase UUID. Variant filenames use the same ID.
      - `extension` (string, required): Extension of the Original, such as `png`.
  - `movies` (array of object, required)
    - `id` (integer, required)
    - `title` (string, required)
    - `year` (integer, nullable, required)
    - `poster` (object, nullable, required)
      - `id` (string (uuid), required): Stable image ID, a lowercase UUID. Variant filenames use the same ID.
      - `extension` (string, required): Extension of the Original, such as `png`.

### 304

Not modified. The `If-None-Match` validator still matches; no body.

### 400

The path is not a valid route, or the request carried a query string or body.

### 404

The resource does not exist or is not public.

### 405

Only `GET`, `HEAD` and `OPTIONS` are supported.

### 429

Too many cache misses from this address. Retry after the `Retry-After` delay.

### 503

Temporarily unavailable. Retry after the `Retry-After` delay.

## Example response (200)

```json
{
  "data": {
    "kind": "company",
    "id": 1,
    "name": "Lucasfilm Ltd.",
    "description": null,
    "originCountry": "US",
    "headquartersCountry": null,
    "homepage": null,
    "parentCompany": null,
    "metadataImages": {
      "logo": {
        "id": "12ecbba1-372d-423c-99cc-eb7f95bf8c11",
        "extension": "avif"
      }
    },
    "movies": [
      {
        "id": 1731694,
        "title": "LEGO Star Wars: The Mandalorian",
        "year": 2026,
        "poster": {
          "id": "32944476-571a-4d22-8748-e5f6c1bc762c",
          "extension": "avif"
        }
      },
      {
        "id": 1228710,
        "title": "The Mandalorian and Grogu",
        "year": 2026,
        "poster": {
          "id": "b807451b-0e97-45b4-8f99-21393e4c8aa2",
          "extension": "avif"
        }
      },
      {
        "id": 1076708,
        "title": "Music by John Williams",
        "year": 2024,
        "poster": {
          "id": "eb2ba52a-3ce9-4541-b934-a591b8709f86",
          "extension": "avif"
        }
      }
    ]
  }
}
```
