> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poddata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Makes a diligence report for a company, with five empty pages

> Makes a diligence report on a company: an overview and five pages (customer, competitive, news, trends and expert), all empty, for your assistant to write a page at a time. A company your team doesn't target yet joins its targets, and `target_added` says so. `201` with the report as a read answers it, the check listing what is still to write.

**Before:** The company's links and rivals are confirmed and PodData has read them: `GET /targets/{company}/coverage` says what was read, and each page's figures come from it.

**Next:** Write each page with `PUT /diligence-reports/{id}/pages/{page}`, then `POST /diligence-reports/{id}/check`. PodData’s own agent writes a report too, started from the workspace.

**Limits:** None beyond the key’s.

**MCP tool:** `start_report`, on PodData's MCP server at `https://api.poddata.ai/mcp`, does what this route does, with the same key. See [The MCP server](https://docs.poddata.ai/mcp.md).


## OpenAPI

````yaml /openapi.json post /diligence-reports
openapi: 3.1.0
info:
  title: PodData API
  version: 1.0.0
  description: >-
    PodData is competitive intelligence from the record: what leaders said on
    podcasts, in interviews and at their own events, as quotes with the speaker,
    the source, the day and the second; and, for a diligence, what public
    sources say about a company and its rivals, read through links a person on
    your team has confirmed.


    ## Quick start


    1. **A key.** Someone on your team makes one in the workspace, Settings ›
    API keys. Send it on every call as `Authorization: Bearer pd_live_…`. Keep
    it in an environment variable, such as `PODDATA_API_KEY`, and never print it
    or write it to a file.

    2. **A target.** `POST /targets` with a company's `name` and `domain`, an id
    from `GET /companies?q=`, or its SEC `ticker`.

    3. **Its links and rivals.** `POST /targets/{company}/find` and `POST
    /targets/{company}/rivals/find` propose them, each with the page that shows
    it. Show each one to a person, and confirm it only on their yes.

    4. **A read.** `POST /targets/{company}/read` with `{"rivals": true}` asks
    PodData to read the target and its confirmed rivals now. `GET
    /targets/{company}/coverage` says what has been read, source by source.

    5. **The files.** `GET /targets/{company}/folder` lists a file for each
    source, for the target and each confirmed rival. `?format=zip` is all of
    them at once.

    6. **A report.** `POST /diligence-reports` makes one with five empty pages.
    Write each with `PUT /diligence-reports/{id}/pages/{page}`, check it with
    `POST /diligence-reports/{id}/check`, and read it with every figure filled
    with `GET /diligence-reports/{id}`. Or have PodData's own agent write it,
    `POST /diligence-reports/{id}/runs`, and follow the run with `GET
    /diligence-runs/{id}`.


    The tags below are in that order. Each operation says what has to be true
    first, what to call next and its limits, with a made-up example of the call
    and its answer.


    **For an assistant,** start from `https://api.poddata.ai/llms.txt`, which
    needs no key: the same steps, the MCP server, and PodData's diligence skill
    with its puller, which saves a target's folder, its rivals' and its reports
    to disk. The MCP server does what the API does:
    `https://api.poddata.ai/mcp`, with the same key or by signing in to PodData,
    and each operation here names its tool in `x-mcp-tool`. To add it to Claude
    Code with the key read from the environment each time it starts, never
    written down, run this as it is, in single quotes: `claude mcp add
    --transport http --scope project poddata https://api.poddata.ai/mcp --header
    'Authorization: Bearer ${PODDATA_API_KEY}'`.


    **Limits.** 120 requests a minute a key, then a `429` with `Retry-After`. A
    team's plan sets how many reads, rival finds and filers it may ask for a
    day, and a call past one is a `403` with the code `plan` that says the
    limit. A list or a file holds at most 80 words in a row of a source's own
    text; a whole document or transcript comes from its own route, one at a
    time, under a daily limit.


    **Errors** are `{"error": {"code": "…", "message": "…"}}`, the message a
    sentence that says what to do.
servers:
  - url: https://api.poddata.ai/v1
security:
  - key: []
tags:
  - name: Targets
    description: >-
      Start here. The companies your team looks at: add one by its name and
      domain, by an id from `GET /companies`, or by its SEC ticker. A target is
      your team's alone, and nothing says another team looks at it.
  - name: Links
    description: >-
      A target's own domain, listings and accounts. PodData proposes them from
      its own site, and reads only through a link a person on your team has
      confirmed.
  - name: Rivals
    description: >-
      The companies a target competes with. PodData finds and tests candidates
      and proposes only the rivals; a person confirms each, and then it is read
      beside the target.
  - name: Reads
    description: >-
      Ask PodData to read a target and its confirmed rivals now, and see what
      has been read for it, source by source, and what is missing and why.
  - name: Records and signals
    description: >-
      What PodData read about a company through its confirmed links: records,
      such as filings, licences, cases and stories, and signals, such as reviews
      and ratings, each with its own day and its page on the source's site. And
      the figures your team's own data licences read.
  - name: Ads and site
    description: >-
      A brand's ads in Meta's US ad library, from PodData's weekly reads, and
      the pages of a company's own site as PodData read them.
  - name: Number tools
    description: >-
      Figures computed on the server, so an assistant never pages through
      thousands of reviews or does the sums itself: ratings, complaints, a
      series, a timeline, ads and a site, for a company beside its confirmed
      rivals. Each answers the figures, the rows behind them, the evidence and
      how they were built.
  - name: Folder
    description: >-
      Everything PodData holds for a target and its confirmed rivals, as files:
      an index, a CSV a source and kind, and one zip.
  - name: Reports
    description: >-
      A diligence report: an overview and five pages, each figure filled by a
      number tool when the report is read, and a check that refuses what the
      evidence doesn't hold. Your own assistant writes it a page at a time, or
      PodData's agent does.
  - name: Report runs
    description: >-
      PodData's own agent writing a report or changing one: each run's status,
      its turns and what it cost.
  - name: Quotes
    description: >-
      What people said, as quotes with the speaker, the show, the day, the
      second and a page to cite.
  - name: People
    description: >-
      The people PodData quotes, their sources and timelines, and lookups of
      someone new.
  - name: Shows and episodes
    description: The shows PodData reads and their episodes, with who spoke when.
  - name: Companies
    description: >-
      What companies said and filed themselves: their documents, events,
      transcripts, slides, posts and figures, and passages of at most 80 words
      from them.
  - name: Trackers
    description: >-
      A tracker follows a topic or a person and sends each new quote it matches
      by email, Slack or webhook.
  - name: Lists
    description: >-
      A team's own lists of people and companies, to narrow a search or a
      tracker to them.
  - name: Saved
    description: >-
      What a person signed in has saved, their saved filters and their calendar
      feed. A key, which has no person, is refused most of these.
  - name: Sources
    description: >-
      The sources PodData reads, what it holds from each, and how much of the
      watch list is covered.
  - name: Webhooks
    description: Webhooks a program registers to be sent what its trackers match.
  - name: Usage
    description: The team's calls and reads, counted by day and kind.
  - name: Help
    description: >-
      PodData's guide to itself: what each part of PodData does and where in the
      workspace it's done, topic by topic.
paths:
  /diligence-reports:
    post:
      tags:
        - Reports
      summary: Makes a diligence report for a company, with five empty pages
      description: >-
        Makes a diligence report on a company: an overview and five pages
        (customer, competitive, news, trends and expert), all empty, for your
        assistant to write a page at a time. A company your team doesn't target
        yet joins its targets, and `target_added` says so. `201` with the report
        as a read answers it, the check listing what is still to write.


        **Before:** The company's links and rivals are confirmed and PodData has
        read them: `GET /targets/{company}/coverage` says what was read, and
        each page's figures come from it.


        **Next:** Write each page with `PUT
        /diligence-reports/{id}/pages/{page}`, then `POST
        /diligence-reports/{id}/check`. PodData’s own agent writes a report too,
        started from the workspace.


        **Limits:** None beyond the key’s.
      operationId: startDiligenceReport
      requestBody:
        required: true
        content:
          application/json:
            examples:
              made-up:
                summary: 'Made up: no team’s data'
                value:
                  company: northwind-dental
                  playbook: '2'
            schema:
              type: object
              properties:
                company:
                  type: string
                  minLength: 1
                  maxLength: 64
                  description: >-
                    Any id /companies/{id} takes. It joins the team’s targets if
                    it isn’t one
                title:
                  type: string
                  minLength: 1
                  maxLength: 120
                  description: >-
                    The company's name as the report writes it; its own name if
                    left out
                playbook:
                  type: string
                  maxLength: 40
                  description: The playbook version the writer follows
              required:
                - company
              additionalProperties: false
      responses:
        '201':
          description: Made
          content:
            application/json:
              examples:
                made-up:
                  summary: 'Made up: no team’s data'
                  value:
                    id: dlr_01JD9K4M5N6P00000000000000
                    company:
                      id: northwind-dental
                      name: Northwind Dental
                    title: Northwind Dental
                    status: draft
                    rev: 1
                    problems: 0
                    playbook: '2'
                    saved_by: key
                    created_at: '2026-11-14T08:00:00.000Z'
                    updated_at: '2026-11-14T08:00:00.000Z'
                    checked_at: null
                    pages:
                      - id: customer
                        state: empty
                      - id: competitive
                        state: empty
                      - id: news
                        state: empty
                      - id: trends
                        state: empty
                      - id: expert
                        state: empty
                    report:
                      version: 1
                      company: northwind-dental
                      title: Northwind Dental
                      playbook: '2'
                      overview:
                        bottom_line: ''
                        cards: []
                        first_question: ''
                        names: []
                      pages:
                        - id: customer
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: competitive
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: news
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: trends
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: expert
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                    filled:
                      version: 1
                      company: northwind-dental
                      title: Northwind Dental
                      playbook: '2'
                      overview:
                        bottom_line: ''
                        cards: []
                        first_question: ''
                        names: []
                      pages:
                        - id: customer
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: competitive
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: news
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: trends
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                        - id: expert
                          state: empty
                          headline: ''
                          lede: ''
                          read: []
                          questions: []
                          exhibits: []
                          quotes: []
                          method:
                            read: ''
                            from: null
                            to: null
                            left_out: []
                          web: []
                          names: []
                    answers: {}
                    cited: {}
                    check:
                      passes: false
                      problems:
                        - where: overview.bottom_line
                          problem: has no bottom line
                          refused: true
                        - where: pages.0
                          problem: the customer page is still empty
                          refused: true
                        - where: pages.1
                          problem: the competitive page is still empty
                          refused: true
                        - where: pages.2
                          problem: the news page is still empty
                          refused: true
                        - where: pages.3
                          problem: the trends page is still empty
                          refused: true
                        - where: pages.4
                          problem: the expert page is still empty
                          refused: true
                    target_added: false
              schema:
                type: object
                properties:
                  id:
                    type: string
                  company:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                    required:
                      - id
                      - name
                  title:
                    type: string
                  status:
                    type: string
                    enum:
                      - draft
                      - checked
                  rev:
                    type: integer
                  problems:
                    type: integer
                  playbook:
                    type:
                      - string
                      - 'null'
                  saved_by:
                    type: string
                    enum:
                      - key
                      - member
                      - agent
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  checked_at:
                    type:
                      - string
                      - 'null'
                  pages:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          enum:
                            - customer
                            - competitive
                            - news
                            - trends
                            - expert
                        state:
                          type: string
                          enum:
                            - empty
                            - written
                            - waits
                      required:
                        - id
                        - state
                  report:
                    type: object
                    properties:
                      version:
                        type: number
                        enum:
                          - 1
                      company:
                        type: string
                      title:
                        type: string
                      playbook:
                        type:
                          - string
                          - 'null'
                      overview:
                        type: object
                        properties:
                          bottom_line:
                            type: string
                          cards:
                            type: array
                            items:
                              type: object
                              properties:
                                exhibit:
                                  type: string
                                figure:
                                  type: string
                                label:
                                  type: string
                                line:
                                  type: string
                              required:
                                - exhibit
                                - figure
                                - label
                                - line
                            maxItems: 3
                          first_question:
                            type: string
                          names:
                            type: array
                            items:
                              type: string
                            maxItems: 100
                        required:
                          - bottom_line
                          - cards
                          - first_question
                          - names
                      pages:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              enum:
                                - customer
                                - competitive
                                - news
                                - trends
                                - expert
                            state:
                              type: string
                              enum:
                                - empty
                                - written
                                - waits
                            headline:
                              type: string
                            lede:
                              type: string
                            read:
                              type: array
                              items:
                                type: object
                                properties:
                                  exhibit:
                                    type: string
                                  figure:
                                    type: string
                                  label:
                                    type: string
                                required:
                                  - exhibit
                                  - figure
                                  - label
                              maxItems: 6
                            questions:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  ask:
                                    type: string
                                  answer:
                                    type: string
                                  cards:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        exhibit:
                                          type: string
                                        figure:
                                          type: string
                                        label:
                                          type: string
                                        line:
                                          type: string
                                      required:
                                        - exhibit
                                        - figure
                                        - label
                                        - line
                                    maxItems: 3
                                required:
                                  - id
                                  - ask
                                  - answer
                                  - cards
                              maxItems: 2
                            exhibits:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  numbers:
                                    type: string
                                  company:
                                    type: string
                                  params:
                                    type: object
                                    additionalProperties:
                                      anyOf:
                                        - type: string
                                        - type: number
                                        - type: boolean
                                        - type: array
                                          items:
                                            type: string
                                  show:
                                    type: string
                                    enum:
                                      - figures
                                      - table
                                      - bars
                                      - share
                                      - series
                                      - timeline
                                  title:
                                    type: string
                                  point:
                                    type: string
                                  caveat:
                                    type:
                                      - string
                                      - 'null'
                                required:
                                  - id
                                  - numbers
                                  - company
                                  - params
                                  - show
                                  - title
                                  - point
                                  - caveat
                              maxItems: 12
                            quotes:
                              type: array
                              items:
                                type: object
                                properties:
                                  kind:
                                    type: string
                                    enum:
                                      - quote
                                      - signal
                                      - passage
                                      - record
                                  id:
                                    type: string
                                  exhibit:
                                    type:
                                      - string
                                      - 'null'
                                  why:
                                    type: string
                                required:
                                  - kind
                                  - id
                                  - exhibit
                                  - why
                              maxItems: 30
                            method:
                              type: object
                              properties:
                                read:
                                  type: string
                                from:
                                  type:
                                    - string
                                    - 'null'
                                  format: date
                                to:
                                  type:
                                    - string
                                    - 'null'
                                  format: date
                                left_out:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      what:
                                        type: string
                                      why:
                                        type: string
                                    required:
                                      - what
                                      - why
                                  maxItems: 30
                              required:
                                - read
                                - from
                                - to
                                - left_out
                            web:
                              type: array
                              items:
                                type: object
                                properties:
                                  url:
                                    type: string
                                  title:
                                    type: string
                                  day:
                                    type:
                                      - string
                                      - 'null'
                                    format: date
                                  day_from:
                                    type: string
                                    enum:
                                      - page
                                      - none
                                  read_at:
                                    type: string
                                    format: date-time
                                  why:
                                    type: string
                                required:
                                  - url
                                  - title
                                  - day
                                  - day_from
                                  - read_at
                                  - why
                              maxItems: 20
                            names:
                              type: array
                              items:
                                type: string
                              maxItems: 100
                          required:
                            - id
                            - state
                            - headline
                            - lede
                            - read
                            - questions
                            - exhibits
                            - quotes
                            - method
                            - web
                            - names
                        maxItems: 5
                    required:
                      - version
                      - company
                      - title
                      - playbook
                      - overview
                      - pages
                  filled:
                    type: object
                    properties:
                      version:
                        type: number
                        enum:
                          - 1
                      company:
                        type: string
                      title:
                        type: string
                      playbook:
                        type:
                          - string
                          - 'null'
                      overview:
                        type: object
                        properties:
                          bottom_line:
                            type: string
                          cards:
                            type: array
                            items:
                              type: object
                              properties:
                                exhibit:
                                  type: string
                                figure:
                                  type: string
                                label:
                                  type: string
                                line:
                                  type: string
                              required:
                                - exhibit
                                - figure
                                - label
                                - line
                            maxItems: 3
                          first_question:
                            type: string
                          names:
                            type: array
                            items:
                              type: string
                            maxItems: 100
                        required:
                          - bottom_line
                          - cards
                          - first_question
                          - names
                      pages:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              enum:
                                - customer
                                - competitive
                                - news
                                - trends
                                - expert
                            state:
                              type: string
                              enum:
                                - empty
                                - written
                                - waits
                            headline:
                              type: string
                            lede:
                              type: string
                            read:
                              type: array
                              items:
                                type: object
                                properties:
                                  exhibit:
                                    type: string
                                  figure:
                                    type: string
                                  label:
                                    type: string
                                required:
                                  - exhibit
                                  - figure
                                  - label
                              maxItems: 6
                            questions:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  ask:
                                    type: string
                                  answer:
                                    type: string
                                  cards:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        exhibit:
                                          type: string
                                        figure:
                                          type: string
                                        label:
                                          type: string
                                        line:
                                          type: string
                                      required:
                                        - exhibit
                                        - figure
                                        - label
                                        - line
                                    maxItems: 3
                                required:
                                  - id
                                  - ask
                                  - answer
                                  - cards
                              maxItems: 2
                            exhibits:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  numbers:
                                    type: string
                                  company:
                                    type: string
                                  params:
                                    type: object
                                    additionalProperties:
                                      anyOf:
                                        - type: string
                                        - type: number
                                        - type: boolean
                                        - type: array
                                          items:
                                            type: string
                                  show:
                                    type: string
                                    enum:
                                      - figures
                                      - table
                                      - bars
                                      - share
                                      - series
                                      - timeline
                                  title:
                                    type: string
                                  point:
                                    type: string
                                  caveat:
                                    type:
                                      - string
                                      - 'null'
                                required:
                                  - id
                                  - numbers
                                  - company
                                  - params
                                  - show
                                  - title
                                  - point
                                  - caveat
                              maxItems: 12
                            quotes:
                              type: array
                              items:
                                type: object
                                properties:
                                  kind:
                                    type: string
                                    enum:
                                      - quote
                                      - signal
                                      - passage
                                      - record
                                  id:
                                    type: string
                                  exhibit:
                                    type:
                                      - string
                                      - 'null'
                                  why:
                                    type: string
                                required:
                                  - kind
                                  - id
                                  - exhibit
                                  - why
                              maxItems: 30
                            method:
                              type: object
                              properties:
                                read:
                                  type: string
                                from:
                                  type:
                                    - string
                                    - 'null'
                                  format: date
                                to:
                                  type:
                                    - string
                                    - 'null'
                                  format: date
                                left_out:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      what:
                                        type: string
                                      why:
                                        type: string
                                    required:
                                      - what
                                      - why
                                  maxItems: 30
                              required:
                                - read
                                - from
                                - to
                                - left_out
                            web:
                              type: array
                              items:
                                type: object
                                properties:
                                  url:
                                    type: string
                                  title:
                                    type: string
                                  day:
                                    type:
                                      - string
                                      - 'null'
                                    format: date
                                  day_from:
                                    type: string
                                    enum:
                                      - page
                                      - none
                                  read_at:
                                    type: string
                                    format: date-time
                                  why:
                                    type: string
                                required:
                                  - url
                                  - title
                                  - day
                                  - day_from
                                  - read_at
                                  - why
                              maxItems: 20
                            names:
                              type: array
                              items:
                                type: string
                              maxItems: 100
                          required:
                            - id
                            - state
                            - headline
                            - lede
                            - read
                            - questions
                            - exhibits
                            - quotes
                            - method
                            - web
                            - names
                        maxItems: 5
                    required:
                      - version
                      - company
                      - title
                      - playbook
                      - overview
                      - pages
                  answers:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        asked_at:
                          type: string
                        answer:
                          type:
                            - object
                            - 'null'
                          properties:
                            numbers:
                              type: string
                              enum:
                                - rating
                                - rating_by_link
                                - rating_rivals
                                - rating_windows
                                - complaints
                                - series
                                - timeline
                                - ads
                                - ads_weeks
                                - site
                                - site_changes
                            company:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                              required:
                                - id
                                - name
                            params:
                              type: object
                              additionalProperties: {}
                            figures:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                    maxLength: 60
                                    pattern: ^[a-z][a-z0-9_]*$
                                  label:
                                    type: string
                                  value:
                                    type:
                                      - number
                                      - 'null'
                                  unit:
                                    type: string
                                    enum:
                                      - count
                                      - stars
                                      - share
                                      - usd
                                      - days
                                      - number
                                  company:
                                    type:
                                      - string
                                      - 'null'
                                  'n':
                                    type:
                                      - integer
                                      - 'null'
                                  small:
                                    type: boolean
                                  interval:
                                    type:
                                      - object
                                      - 'null'
                                    properties:
                                      low:
                                        type: number
                                      high:
                                        type: number
                                    required:
                                      - low
                                      - high
                                required:
                                  - name
                                  - label
                                  - value
                                  - unit
                                  - company
                                  - 'n'
                                  - small
                                  - interval
                            columns:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                    maxLength: 60
                                    pattern: ^[a-z][a-z0-9_]*$
                                  label:
                                    type: string
                                  unit:
                                    type: string
                                    enum:
                                      - count
                                      - stars
                                      - share
                                      - usd
                                      - days
                                      - number
                                required:
                                  - name
                                  - label
                                  - unit
                            rows:
                              type: array
                              items:
                                type: object
                                properties:
                                  key:
                                    type: string
                                  label:
                                    type: string
                                  kind:
                                    type: string
                                    enum:
                                      - company
                                      - link
                                      - star
                                      - period
                                      - topic
                                      - event
                                  company:
                                    type:
                                      - string
                                      - 'null'
                                  values:
                                    type: object
                                    additionalProperties:
                                      type:
                                        - number
                                        - 'null'
                                  small:
                                    type: boolean
                                  day:
                                    type:
                                      - string
                                      - 'null'
                                  source:
                                    type:
                                      - string
                                      - 'null'
                                  category:
                                    type:
                                      - string
                                      - 'null'
                                  url:
                                    type:
                                      - string
                                      - 'null'
                                  was:
                                    type:
                                      - array
                                      - 'null'
                                    items:
                                      type: object
                                      properties:
                                        label:
                                          type: string
                                        values:
                                          type: object
                                          additionalProperties:
                                            type:
                                              - number
                                              - 'null'
                                        day:
                                          type:
                                            - string
                                            - 'null'
                                        seen_from:
                                          type: string
                                        seen_to:
                                          type: string
                                      required:
                                        - label
                                        - values
                                        - day
                                        - seen_from
                                        - seen_to
                                required:
                                  - key
                                  - label
                                  - kind
                                  - company
                                  - values
                                  - small
                                  - day
                                  - source
                                  - category
                                  - url
                                  - was
                            evidence:
                              type: object
                              properties:
                                items:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      kind:
                                        type: string
                                        enum:
                                          - signal
                                          - record
                                          - document
                                          - quote
                                          - snapshot
                                      id:
                                        type: string
                                      source:
                                        type: string
                                      company:
                                        type:
                                          - string
                                          - 'null'
                                      link:
                                        type:
                                          - string
                                          - 'null'
                                      day:
                                        type:
                                          - string
                                          - 'null'
                                      url:
                                        type:
                                          - string
                                          - 'null'
                                      row:
                                        type:
                                          - string
                                          - 'null'
                                      rating:
                                        type:
                                          - number
                                          - 'null'
                                      text:
                                        type:
                                          - string
                                          - 'null'
                                    required:
                                      - kind
                                      - id
                                      - source
                                      - company
                                      - link
                                      - day
                                      - url
                                      - row
                                      - rating
                                      - text
                                  maxItems: 200
                                total:
                                  type: integer
                                more:
                                  type: integer
                              required:
                                - items
                                - total
                                - more
                            basis:
                              type: object
                              properties:
                                sources:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      id:
                                        type: string
                                      name:
                                        type: string
                                      network:
                                        type: string
                                    required:
                                      - id
                                      - name
                                      - network
                                independent:
                                  type: integer
                                window:
                                  type:
                                    - object
                                    - 'null'
                                  properties:
                                    from:
                                      type: string
                                    to:
                                      type: string
                                  required:
                                    - from
                                    - to
                                compare:
                                  type:
                                    - object
                                    - 'null'
                                  properties:
                                    from:
                                      type: string
                                    to:
                                      type: string
                                  required:
                                    - from
                                    - to
                                method:
                                  type: string
                                sample:
                                  type: object
                                  properties:
                                    read:
                                      type: integer
                                    of:
                                      type:
                                        - integer
                                        - 'null'
                                    from:
                                      type:
                                        - string
                                        - 'null'
                                    to:
                                      type:
                                        - string
                                        - 'null'
                                    days:
                                      type: integer
                                    undated:
                                      type: integer
                                  required:
                                    - read
                                    - of
                                    - from
                                    - to
                                    - days
                                    - undated
                                breaks:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      sources:
                                        type: array
                                        items:
                                          type: string
                                      from:
                                        type: string
                                      to:
                                        type:
                                          - string
                                          - 'null'
                                      approximate:
                                        type: boolean
                                      effect:
                                        type: string
                                        enum:
                                          - mark
                                          - mask
                                      what:
                                        type: string
                                      url:
                                        type: string
                                    required:
                                      - sources
                                      - from
                                      - to
                                      - approximate
                                      - effect
                                      - what
                                      - url
                                periods:
                                  type:
                                    - object
                                    - 'null'
                                  properties:
                                    has:
                                      type: array
                                      items:
                                        type: string
                                    lacks:
                                      type: array
                                      items:
                                        type: string
                                  required:
                                    - has
                                    - lacks
                                left_out:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      what:
                                        type: string
                                      count:
                                        type: integer
                                      why:
                                        type: string
                                    required:
                                      - what
                                      - count
                                      - why
                                caveats:
                                  type: array
                                  items:
                                    type: string
                              required:
                                - sources
                                - independent
                                - window
                                - compare
                                - method
                                - sample
                                - breaks
                                - periods
                                - left_out
                                - caveats
                            computed_at:
                              type: string
                          required:
                            - numbers
                            - company
                            - params
                            - figures
                            - columns
                            - rows
                            - evidence
                            - basis
                            - computed_at
                        error:
                          type:
                            - object
                            - 'null'
                          properties:
                            code:
                              type: string
                            message:
                              type: string
                          required:
                            - code
                            - message
                      required:
                        - asked_at
                        - answer
                        - error
                  cited:
                    type: object
                    additionalProperties:
                      type:
                        - object
                        - 'null'
                      properties:
                        kind:
                          type: string
                          enum:
                            - quote
                            - signal
                            - passage
                            - record
                        id:
                          type: string
                        text:
                          type:
                            - string
                            - 'null'
                        day:
                          type:
                            - string
                            - 'null'
                        url:
                          type: string
                        cite:
                          type: string
                        rating:
                          type:
                            - number
                            - 'null'
                        speaker_confirmed:
                          type:
                            - boolean
                            - 'null'
                      required:
                        - kind
                        - id
                        - text
                        - day
                        - url
                        - cite
                        - rating
                        - speaker_confirmed
                  check:
                    type: object
                    properties:
                      passes:
                        type: boolean
                      problems:
                        type: array
                        items:
                          type: object
                          properties:
                            where:
                              type: string
                            problem:
                              type: string
                            refused:
                              type: boolean
                          required:
                            - where
                            - problem
                            - refused
                    required:
                      - passes
                      - problems
                  target_added:
                    type: boolean
                required:
                  - id
                  - company
                  - title
                  - status
                  - rev
                  - problems
                  - playbook
                  - saved_by
                  - created_at
                  - updated_at
                  - checked_at
                  - pages
                  - report
                  - filled
                  - answers
                  - cited
                  - check
        default:
          description: An error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      x-codeSamples:
        - lang: bash
          label: curl, made-up values
          source: |-
            curl -X POST 'https://api.poddata.ai/v1/diligence-reports' \
              -H "Authorization: Bearer $PODDATA_API_KEY" \
              -H 'Content-Type: application/json' \
              -d '{"company":"northwind-dental","playbook":"2"}'
components:
  schemas:
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - no_key
                - plan
                - forbidden
                - not_found
                - conflict
                - unclear
                - slow_down
                - internal
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    key:
      type: http
      scheme: bearer
      description: >-
        An API key, sent as `Authorization: Bearer pd_live_…`. Someone on your
        team makes one in the workspace, Settings › API keys; it's shown once.
        Staging's keys start with `pd_test_`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.