---
title: "One marketing project"
method: GET
path: "/marketing/projects/{id}"
tags: ["marketing"]
---

# One marketing project

`GET /marketing/projects/{id}`

## Request

- Base URL: `https://api.gogoscreen.com/api/v1`
- URL: `https://api.gogoscreen.com/api/v1/marketing/projects/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The whole editor read for one project: the project row, its current revision (scenes, copy, music, timing), the state of its source and which slots still need a picture, the template at the version THIS project records — never the catalogue's newest — the music credit, and its exports newest first.

## Path parameters

- `id` string, uuid, required

## Response `200`

One marketing project

- object
  - `credit` object, nullable, required: The music credit this revision's bed owes. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
  - `exports` object[], required
    - `id` string, required
    - `state` string, required
    - `status` string, required
  - `narration` object, nullable, required: Whether this deployment can speak a written narration, and the sentence when it cannot. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
  - `preview` object, nullable, required: What a preview of the current revision would play. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
  - `project` object, required
    - `createdAt` string, date-time, nullable, required
    - `currentRevisionId` string, nullable, required
    - `id` string, required
    - `marketingSourceId` string, nullable, required
    - `sourceKind` 'walkthrough' | 'website', required
    - `sourceRenderId` string, nullable, required
    - `status` string, required
    - `templateId` string, required
    - `templateVersion` string, required
    - `title` string, required
    - `updatedAt` string, date-time, nullable, required
  - `revision` object, nullable, required
    - `createdAt` string, date-time, nullable, required
    - `document` object, required: The revision's own document: the scenes, the copy, the music and the timing. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
    - `id` string, required
    - `locks` object, required: The parts of this revision the customer has locked. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
    - `number` number, required
    - `parentRevisionId` string, nullable, required
    - `projectId` string, required
    - `restoredFromRevisionId` string, nullable, required
    - `seed` number, required
  - `slots` object[], required: The picture slots of the design and what each could be filled with.
  - `source` object, nullable, required: The state of what the project is made from. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
  - `template` object, nullable, required: The template at the version this project records. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.

## Other responses

- `400`: `validation_failed` — That request is not valid.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs.
- `404`: `not_found` — No such resource.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.

---

[API](https://skmtc.dev/gogoscreen/apis/gogoscreen-api.md) · [All operations](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/revisions/2fd812319d75?raw)