> **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).

# githubLookupPoll

`POST /v1/github-lookup/poll`

**Tags:** `GitHub`

Poll GitHub lookup results

**Endpoint:** `https://api.fiber.ai/v1/github-lookup/poll`

## Description

Poll for the results of a GitHub lookup task. Returns progress breakdown and all completed results in a single response (no pagination).

⚡ Rate limit: 120 requests per 1 minute

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "githubAgentRunId": {
      "type": "string",
      "description": "The ID of the GitHub lookup agent run which you got back from the trigger endpoint."
    }
  },
  "required": [
    "apiKey",
    "githubAgentRunId"
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "githubAgentRunId": {
          "type": "string",
          "description": "The ID of the GitHub lookup run these results belong to."
        },
        "overallStatus": {
          "type": "string",
          "enum": [
            "NOT_STARTED",
            "STARTED",
            "DONE",
            "FAILED"
          ],
          "description": "The overall status of the lookup run."
        },
        "counts": {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer",
              "description": "Total number of people submitted in this run."
            },
            "found": {
              "type": "integer",
              "description": "Number of people for whom a GitHub profile was found."
            },
            "notFound": {
              "type": "integer",
              "description": "Number of people for whom no GitHub profile could be found after searching."
            },
            "invalidInput": {
              "type": "integer",
              "description": "Number of people whose input could not be resolved (e.g. unresolvable LinkedIn URL, insufficient information)."
            },
            "failed": {
              "type": "integer",
              "description": "Number of people whose lookup failed due to a system error."
            },
            "pending": {
              "type": "integer",
              "description": "Number of people still waiting to be processed."
            }
          },
          "required": [
            "total",
            "found",
            "notFound",
            "invalidInput",
            "failed",
            "pending"
          ],
          "description": "Breakdown of lookup progress. All fields sum to the total number of people in the run."
        },
        "people": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "person": {
                "type": "object",
                "properties": {
                  "fullName": {
                    "type": "string",
                    "description": "The full name of the person."
                  },
                  "company": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Company provided in the original input."
                  },
                  "jobTitle": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Job title provided in the original input."
                  },
                  "workEmail": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Work email provided in the original input."
                  },
                  "linkedInUrl": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "LinkedIn URL provided or resolved from the original input."
                  },
                  "linkedinUserId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "LinkedIn numeric user ID if provided in the original input."
                  },
                  "customerProvidedId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "The external ID echoed back from the input for joining results to the original dataset."
                  }
                },
                "required": [
                  "fullName"
                ],
                "description": "The original input person."
              },
              "githubProfile": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "outcome": {
                        "type": "string",
                        "enum": [
                          "found"
                        ]
                      },
                      "username": {
                        "type": "string",
                        "description": "The GitHub username (login) for the matched profile."
                      },
                      "githubUrl": {
                        "type": "string",
                        "format": "uri",
                        "description": "The GitHub profile URL."
                      },
                      "displayName": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "The user's display name on GitHub."
                      },
                      "profilePictureUrl": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "uri",
                        "description": "URL to the user's GitHub profile picture."
                      },
                      "bio": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "One-line summary below the person's name on GitHub."
                      },
                      "location": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Location as displayed on the GitHub profile."
                      },
                      "numRepositories": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "Number of public repositories."
                      },
                      "numFollowers": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "Number of followers on GitHub."
                      },
                      "confidenceOutOf10": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10,
                        "description": "Confidence score between 1 and 10 denoting the match quality."
                      },
                      "rationale": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Short explanation of why this GitHub profile was matched to the person, referencing details like name, company, or location."
                      }
                    },
                    "required": [
                      "outcome",
                      "username",
                      "githubUrl",
                      "confidenceOutOf10"
                    ]
                  },
                  {
                    "type": "object",
                    "properties": {
                      "outcome": {
                        "type": "string",
                        "enum": [
                          "notFound"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "description": "A user-facing explanation of why no profile was found."
                      }
                    },
                    "required": [
                      "outcome",
                      "message"
                    ]
                  },
                  {
                    "type": "object",
                    "properties": {
                      "outcome": {
                        "type": "string",
                        "enum": [
                          "invalidInput"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "description": "A user-facing explanation of why the lookup could not proceed."
                      }
                    },
                    "required": [
                      "outcome",
                      "message"
                    ]
                  },
                  {
                    "type": "object",
                    "properties": {
                      "outcome": {
                        "type": "string",
                        "enum": [
                          "failed"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "description": "A user-facing explanation of the failure."
                      }
                    },
                    "required": [
                      "outcome",
                      "message"
                    ]
                  }
                ],
                "description": "The GitHub lookup result for this person."
              }
            },
            "required": [
              "person",
              "githubProfile"
            ]
          },
          "description": "All processed people sorted by outcome (found first). Pending people are not included."
        }
      },
      "required": [
        "githubAgentRunId",
        "overallStatus",
        "counts",
        "people"
      ]
    },
    "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",
      "items": {
        "type": "string"
      },
      "default": [],
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo",
    "advice"
  ],
  "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)