> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# pollDepthChart

`POST /v1/depth-chart/poll`

**Tags:** `Company info`

Poll depth chart generation result

**Endpoint:** `https://api.fiber.ai/v1/depth-chart/poll`

## Description

Retrieves the employee breakdown started by the `depth-chart/start` endpoint. Pass the report ID you received when you started the report. Returns the current status and, once complete, numerical counts of employees grouped by department, seniority, or both, plus a printable markdown summary in tabular format — useful for CLI output or for LLMs building reports. Returns summary stats per bucket, not the individual people in each bucket.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: FREE! No credits are charged for this API. ⓘ

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "reportId": {
      "type": "string",
      "minLength": 1,
      "description": "Report ID returned by the /depth-chart/start endpoint"
    }
  },
  "required": [
    "apiKey",
    "reportId"
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "description": "Report is still being generated",
              "enum": [
                "pending"
              ]
            }
          },
          "required": [
            "status"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "description": "Report generation succeeded",
              "enum": [
                "completed"
              ]
            },
            "report": {
              "type": "object",
              "properties": {
                "reportId": {
                  "type": "string",
                  "description": "Unique identifier for this report"
                },
                "companyInfo": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Company name"
                    },
                    "linkedinUrl": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Full LinkedIn company profile URL"
                    },
                    "linkedinOrgId": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "LinkedIn organization ID for the company"
                    },
                    "domain": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Company primary domain"
                    }
                  },
                  "description": "Company identification details"
                },
                "totalEmployees": {
                  "type": "number",
                  "description": "Total employees at the company (official headcount when available, otherwise the classified count)"
                },
                "classifiedEmployees": {
                  "type": "number",
                  "description": "Number of employees categorized in this depth chart. Bucket counts sum to this value."
                },
                "categorizationNote": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Explanation when the company is too large to categorize every employee in full"
                },
                "averageTenureMonths": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Overall average tenure in months across all employees"
                },
                "buckets": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "function": {
                        "type": "string",
                        "description": "Functional area (e.g. Engineering, Sales/GTM, Marketing, Product)"
                      },
                      "seniority": {
                        "type": "string",
                        "description": "Seniority level (Junior, Mid-Level, Senior, Manager, Executive)"
                      },
                      "totalEmployees": {
                        "type": "number",
                        "description": "Number of employees in this function x seniority combination"
                      },
                      "averageTenureMonths": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Average tenure in months for employees in this combination"
                      }
                    },
                    "required": [
                      "function",
                      "seniority",
                      "totalEmployees",
                      "averageTenureMonths"
                    ]
                  },
                  "description": "One entry per function x seniority combination with headcount and average tenure. Includes summary stats for each bucket, but does not list the people in each bucket."
                },
                "seniorityStats": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "seniority": {
                        "type": "string",
                        "description": "Seniority level (Junior, Mid-Level, Senior, Manager, Executive)"
                      },
                      "totalEmployees": {
                        "type": "number",
                        "description": "Total employees at this seniority level"
                      },
                      "averageTenureMonths": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Average tenure in months across all functions at this seniority level"
                      }
                    },
                    "required": [
                      "seniority",
                      "totalEmployees",
                      "averageTenureMonths"
                    ]
                  },
                  "description": "Aggregated headcount and tenure per seniority level"
                },
                "functionStats": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "function": {
                        "type": "string",
                        "description": "Functional area (e.g. Engineering, Sales/GTM, Marketing)"
                      },
                      "totalEmployees": {
                        "type": "number",
                        "description": "Total employees in this function"
                      },
                      "averageTenureMonths": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Average tenure in months across all seniority levels in this function"
                      }
                    },
                    "required": [
                      "function",
                      "totalEmployees",
                      "averageTenureMonths"
                    ]
                  },
                  "description": "Aggregated headcount and tenure per functional area"
                },
                "markdownSummary": {
                  "type": "string",
                  "description": "Human-readable markdown summary of the depth chart, including a grid table of employee counts by function and seniority"
                }
              },
              "required": [
                "reportId",
                "companyInfo",
                "totalEmployees",
                "classifiedEmployees",
                "categorizationNote",
                "averageTenureMonths",
                "buckets",
                "seniorityStats",
                "functionStats",
                "markdownSummary"
              ],
              "description": "The completed depth chart report"
            }
          },
          "required": [
            "status",
            "report"
          ]
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "description": "Report generation failed",
              "enum": [
                "failed"
              ]
            },
            "errorMessage": {
              "type": "string",
              "description": "Description of why generation failed"
            }
          },
          "required": [
            "status",
            "errorMessage"
          ]
        }
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)