---
title: "Prepare Human verification for the company a held pull request adds, at its exact current head."
method: POST
path: "/v1/startup-credits/pull-request-review-preparations"
tags: ["Catalog"]
---

# Prepare Human verification for the company a held pull request adds, at its exact current head.

`POST /v1/startup-credits/pull-request-review-preparations`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/startup-credits/pull-request-review-preparations`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- PrepareStartupCreditsPullRequestReviewRequest
  - `target` object, required
    - `head_sha` string, required
    - `kind` 'git_pull_request', required
    - `pull_request_number` integer, required
    - `repository` string, required

## Response `200`

Successful response.

- PrepareStartupCreditsPullRequestReviewResponse200
  - `data` union, required
    - object
      - `offer` object, required
        - `authoring_digest` string, required
        - `base_release_id` string, required
        - `entity_id` string, required
        - `kind` 'git_pull_request', required
        - `labels` object, required
          - `company_name` string, required
          - `company_site_url` string, uri, required
          - `offer_title` string, required
          - `offer_url` string, uri, required
        - `offer_id` string, required
        - `program_id` string
        - `pull_request` object, required
          - `head_sha` string, required
          - `pull_request_number` integer, required
          - `repository` string, required
          - `repository_id` string, required
          - `submission_id` string, required
        - `revisions` object, required
          - `entity_revision_digest` string, required
          - `offer_revision_digest` string, required
        - `standing_result` object, required
          - `evaluated_at` string, date-time, required
          - `evidence_digest` string, required
          - `expires_at` string, date-time, required
          - `official_source_url` string, uri, required
          - `policy_digest` string, required
          - `reasons` string[], required
          - `registrable_domain` string, required
          - `result_contract` 'sourcey.standing-result/v1alpha1', required
          - `result_digest` string, required
          - `route` 'correction_required' | 'repair_required' | 'temporarily_unavailable' | 'free_machine_review' | 'human_verification_required', required
      - `purchase_preview` object, required
        - `disclosure` 'Human verification includes publication of a supportable company record with verified status for a legitimate company. Sourcey cannot publish false, unsafe, conflicting, duplicate, or non-existent company or offer claims. Refunds apply when Sourcey cannot deliver the purchased service or misses the review deadline.', required
        - `passing_results` object, required
          - `entity_identity` object, required
            - `binding` 'identity-epoch', required
            - `status` 'verified', required
          - `offer_terms` object, required
            - `binding` 'exact-offer-revision', required
            - `status` 'checked', required
        - `policy_bindings` object, required
          - `assurance_method` string, required
          - `purchase_disclosure` string, required
          - `service` string, required
        - `preview_contract` 'sourcey.startup-credits-purchase-preview/v1alpha1', required
        - `preview_digest` string, required
        - `price` object, required
          - `currency` 'usd', required
          - `minor_units` 2900, required
        - `price_lookup_key` 'startup-offer-human-verification-usd-29', required
        - `product_code` 'startup-offer-human-verification', required
        - `purchase_kind` 'one_off', required
        - `refunds` object, required
          - `material_misrepresentation_refundable` false, required
          - `service_level_missed_refundable` true, required
          - `sourcey_error_refundable` true, required
        - `service_level` object, required
          - `business_days` 3, required
          - `starts_after` 'settled-payment', required
          - `time_zone` 'Australia/Sydney', required
        - `work_scope` 'one-entity-one-offer', required
      - `target` object, required
        - `expected_purchase_preview_digest` string, required
        - `head_sha` string, required
        - `kind` 'git_pull_request', required
        - `pull_request_number` integer, required
        - `repository` string, required
    - object
      - `company` object, required
        - `authoring_digest` string, required
        - `base_release_id` string, required
        - `entity_id` string, required
        - `kind` 'git_pull_request', required
        - `labels` object, required
          - `company_name` string, required
          - `company_site_url` string, uri, required
        - `pull_request` object, required
          - `head_sha` string, required
          - `pull_request_number` integer, required
          - `repository` string, required
          - `repository_id` string, required
          - `submission_id` string, required
        - `revisions` object, required
          - `entity_revision_digest` string, required
        - `standing_result` object, required
          - `evaluated_at` string, date-time, required
          - `evidence_digest` string, required
          - `expires_at` string, date-time, required
          - `official_source_url` string, uri, required
          - `policy_digest` string, required
          - `reasons` string[], required
          - `registrable_domain` string, required
          - `result_contract` 'sourcey.standing-result/v1alpha1', required
          - `result_digest` string, required
          - `route` 'correction_required' | 'repair_required' | 'temporarily_unavailable' | 'free_machine_review' | 'human_verification_required', required
      - `purchase_preview` object, required
        - `disclosure` 'Human verification of a company includes publication of a supportable company record with verified status for a legitimate company. Sourcey cannot publish false, unsafe, conflicting, duplicate, or non-existent company claims. Refunds apply when Sourcey cannot deliver the purchased service or misses the review deadline.', required
        - `passing_results` object, required
          - `entity_identity` object, required
            - `binding` 'identity-epoch', required
            - `status` 'verified', required
        - `policy_bindings` object, required
          - `assurance_method` string, required
          - `purchase_disclosure` string, required
          - `service` string, required
        - `preview_contract` 'sourcey.company-purchase-preview/v1alpha1', required
        - `preview_digest` string, required
        - `price` object, required
          - `currency` 'usd', required
          - `minor_units` 2900, required
        - `price_lookup_key` 'company-human-verification-usd-29', required
        - `product_code` 'company-human-verification', required
        - `purchase_kind` 'one_off', required
        - `refunds` object, required
          - `material_misrepresentation_refundable` false, required
          - `service_level_missed_refundable` true, required
          - `sourcey_error_refundable` true, required
        - `service_level` object, required
          - `business_days` 3, required
          - `starts_after` 'settled-payment', required
          - `time_zone` 'Australia/Sydney', required
        - `work_scope` 'one-entity', required
      - `target` object, required
        - `expected_purchase_preview_digest` string, required
        - `head_sha` string, required
        - `kind` 'git_pull_request', required
        - `pull_request_number` integer, required
        - `repository` string, required

## Other responses

- `400`: Invalid request.
- `401`: HTTP 401 response.
- `403`: HTTP 403 response.
- `405`: HTTP 405 response.
- `409`: HTTP 409 response.
- `429`: HTTP 429 response.
- `500`: HTTP 500 response.
- `503`: HTTP 503 response.

---

[API](https://skmtc.dev/sourcey/apis/sourcey-public-api.md) · [All operations](https://skmtc.dev/sourcey/apis/sourcey-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sourcey/apis/sourcey-public-api/revisions/437166b51fa5?raw)