App Builds

List App Builds

Returns a paginated list of build artifacts for an app, newest first, with optional platform, status, and creation-date filters.

get/app_builds

Query parameters

app_idstring required

The app to list builds for, prefixed app_.

platform'ios' | 'android' | 'web'

Filter builds by target platform.

status'draft' | 'pending' | 'approved' | 'rejected'

Filter builds by review status.

integer
OR
string

Only return builds created before this ISO 8601 timestamp.

integer
OR
string

Only return builds created after this ISO 8601 timestamp.

firstinteger

The number of builds to return (default 20, max 100).

afterstring

A cursor; returns builds after this position.

lastinteger

The number of builds to return from the end of the range.

beforestring

A cursor; returns builds before this position.

Response

app builds listed

Example response

{
  "data": [
    {
      "checksum": "xxxxxxxxxxxxxxx",
      "created_at": "2026-01-01T12:00:00.000Z",
      "file_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "id": "apbu_xxxxxxxxxxxxxx",
      "platform": "ios",
      "review_message": "The hub view crashes on launch when the member has no active membership. Fix and resubmit.",
      "source_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "status": "rejected",
      "supported_app_view_types": [
        "hub"
      ]
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Changed in 3 of the 41 revisions of this API.61528

    • added the optional property error/code to the response with the 400 status

      response-optional-property-added

    • added the optional property error/code to the response with the 401 status

      response-optional-property-added

    • added the optional property error/code to the response with the 403 status

      response-optional-property-added

    • added the optional property error/code to the response with the 404 status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new analytics enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new dash enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new dashboard enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new discover enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new hub enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new openapi enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new skills enum value to the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 60bbb4a6ffbc6824See the full diff
    • the query request parameter platform was restricted to a list of enum values

      request-parameter-became-enum

    • the query request parameter status was restricted to a list of enum values

      request-parameter-became-enum

    • for the query request parameter created_after, the type/format was changed from string null/date-time to integer string/

      request-parameter-type-changed

    • for the query request parameter created_before, the type/format was changed from string null/date-time to integer string/

      request-parameter-type-changed

    • the response property data/items/file_url became nullable for the status 200

      response-property-became-nullable

    • the data/items/created_at response's property type/format changed from string/date-time to string/ for status 200

      response-property-type-changed

    • removed the optional property error/code from the response with the 400 status

      response-optional-property-removed

    • removed the optional property error/code from the response with the 401 status

      response-optional-property-removed

    • removed the optional property error/code from the response with the 403 status

      response-optional-property-removed

    • removed the optional property error/code from the response with the 404 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 400 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 401 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 403 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 404 status

      response-optional-property-removed

    • api operation id listAppBuild removed and replaced with listAppBuilds

      api-operation-id-removed

    • api tag App Builds added

      api-tag-added

    • api tag App builds removed

      api-tag-removed

    • added the new optional header request parameter Api-Version-Date to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • added the new enum value android to the query request parameter platform

      request-parameter-enum-value-added

    • added the new enum value approved to the query request parameter status

      request-parameter-enum-value-added

    • added the new enum value draft to the query request parameter status

      request-parameter-enum-value-added

    • added the new enum value ios to the query request parameter platform

      request-parameter-enum-value-added

    • added the new enum value pending to the query request parameter status

      request-parameter-enum-value-added

    • added the new enum value rejected to the query request parameter status

      request-parameter-enum-value-added

    • added the new enum value web to the query request parameter platform

      request-parameter-enum-value-added

    • for the query request parameter platform, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • for the query request parameter status, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • removed the non-success response with the status 422

      response-non-success-status-removed

    • removed the non-success response with the status 429

      response-non-success-status-removed

    • removed the non-success response with the status 500

      response-non-success-status-removed

    • removed the analytics enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • removed the dash enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • removed the dashboard enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • removed the discover enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • removed the hub enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • removed the openapi enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • removed the skills enum value from the data/items/supported_app_view_types/items/ response property for the response status 200

      response-property-enum-value-removed

    • added the required property data/items/source_url to the response with the 200 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog