---
title: "Proof-of-display report"
method: GET
path: "/bookings/{booking_id}/report"
tags: ["Bookings"]
---

# Proof-of-display report

`GET /bookings/{booking_id}/report`

## Request

- Base URL: `https://wall.marketing/api/v1`
- URL: `https://wall.marketing/api/v1/bookings/{booking_id}/report`
- Auth: HTTP bearer

Days each screen confirmed showing the advert, with estimated views. No personal data about viewers.

## Path parameters

- `booking_id` string, required

## Response `200`

OK

- Report
  - `object` string: Always "report".
  - `booking_id` string: The booking reported on.
  - `livemode` boolean: False in the sandbox (figures simulated).
  - `status` string: The booking's status.
  - `campaign_name` string: The campaign name.
  - `generated_at` string, nullable: When the report was made. ISO 8601, UTC.
  - `method` string: How days are confirmed and views estimated.
  - `totals` object: Totals over all placements.
    - `days_booked` integer: Days booked across all screens.
    - `days_confirmed` integer: Days a screen confirmed showing the advert.
    - `estimated_views` number, nullable: Days confirmed times each venue's estimated daily visitors.
    - `credit_usd` number: Credit owed for booked days no screen confirmed, once finished.
  - `placements` object[]: One per venue.
    - `venue_id` string: The venue (screen) booked.
    - `venue_name` string: The venue's name.
    - `address` string, nullable: The venue's address.
    - `start_date` string: First day the advert shows.
    - `end_date` string: Exclusive: the first day it no longer shows.
    - `last_day` string, nullable: The last day the advert shows (YYYY-MM-DD).
    - `days` integer: Days booked.
    - `amount_usd` number: Price for this venue, in US dollars.
    - `state` string: not_started, scheduled, live, finished or removed.
    - `days_booked` integer: Days booked at this venue.
    - `days_confirmed` integer: Days this screen confirmed showing the advert.
    - `first_confirmed_at` string, nullable: First confirmation. ISO 8601, UTC.
    - `last_confirmed_at` string, nullable: Latest confirmation. ISO 8601, UTC.
    - `screen_online` boolean: Whether the screen checked in within 26 hours.
    - `showing_now` boolean: Whether the screen reported this advert at its latest check-in.
    - `credit_usd` number: Credit for unconfirmed days at this venue.
    - `estimated_views` number, nullable: Estimated views at this venue.
  - `personal_data` string: What is recorded about viewers (nothing).

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `429`: Error

---

[API](https://skmtc.dev/wall/apis/wall-marketing-platform-api.md) · [All operations](https://skmtc.dev/wall/apis/wall-marketing-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wall/apis/wall-marketing-platform-api/revisions/290b284951e3?raw)