openapi: 3.0.1 info: title: App Store Connect AccessibilityDeclarations ReviewSubmissions API version: 4.3.1 x-platforms: app_store_connect_api: App Store Connect API description: The App Store Connect API is the standards-based REST API Apple provides to automate tasks across App Store Connect, Xcode, and Certificates, Identifiers & Profiles. It covers apps, builds, TestFlight, in-app purchases, subscriptions, Game Center, Xcode Cloud, provisioning, pricing and availability, and the full reporting surface (analytics, sales and trends, financial reports, power and performance). This spec is the official OpenAPI 3.0 document published by Apple at https://developer.apple.com/app-store-connect/api/ — mirrored here unmodified except for title-cased operation summaries. servers: - url: https://api.appstoreconnect.apple.com/ security: - itc-bearer-token: [] tags: - name: ReviewSubmissions paths: /v1/reviewSubmissions: get: tags: - ReviewSubmissions operationId: reviewSubmissions_getCollection parameters: - name: filter[platform] in: query description: filter by attribute 'platform' schema: type: array items: type: string enum: - IOS - MAC_OS - TV_OS - VISION_OS style: form explode: false required: false - name: filter[state] in: query description: filter by attribute 'state' schema: type: array items: type: string enum: - READY_FOR_REVIEW - WAITING_FOR_REVIEW - IN_REVIEW - UNRESOLVED_ISSUES - CANCELING - COMPLETING - COMPLETE style: form explode: false required: false - name: filter[app] in: query description: filter by id(s) of related 'app' schema: type: array items: type: string style: form explode: false required: true - name: fields[reviewSubmissions] in: query description: the fields to include for returned resources of type reviewSubmissions schema: type: array items: type: string enum: - platform - submittedDate - state - app - items - appStoreVersionForReview - submittedByActor - lastUpdatedByActor style: form explode: false required: false - name: fields[apps] in: query description: the fields to include for returned resources of type apps schema: type: array items: type: string enum: - accessibilityUrl - name - bundleId - sku - primaryLocale - isOrEverWasMadeForKids - subscriptionStatusUrl - subscriptionStatusUrlVersion - subscriptionStatusUrlForSandbox - subscriptionStatusUrlVersionForSandbox - contentRightsDeclaration - streamlinedPurchasingEnabled - accessibilityDeclarations - appEncryptionDeclarations - appStoreIcon - ciProduct - betaTesters - betaGroups - appStoreVersions - appTags - preReleaseVersions - betaAppLocalizations - builds - betaLicenseAgreement - betaAppReviewDetail - appInfos - appClips - appPricePoints - endUserLicenseAgreement - appPriceSchedule - appAvailabilityV2 - inAppPurchases - subscriptionGroups - gameCenterEnabledVersions - perfPowerMetrics - appCustomProductPages - inAppPurchasesV2 - promotedPurchases - appEvents - reviewSubmissions - subscriptionGracePeriod - customerReviews - customerReviewSummarizations - gameCenterDetail - appStoreVersionExperimentsV2 - alternativeDistributionKey - analyticsReportRequests - marketplaceSearchDetail - buildUploads - backgroundAssets - betaFeedbackScreenshotSubmissions - betaFeedbackCrashSubmissions - searchKeywords - webhooks - androidToIosAppMappingDetails style: form explode: false required: false - name: fields[reviewSubmissionItems] in: query description: the fields to include for returned resources of type reviewSubmissionItems schema: type: array items: type: string enum: - state - appStoreVersion - appCustomProductPageVersion - appStoreVersionExperiment - appStoreVersionExperimentV2 - appEvent - backgroundAssetVersion - gameCenterAchievementVersion - gameCenterActivityVersion - gameCenterChallengeVersion - gameCenterLeaderboardSetVersion - gameCenterLeaderboardVersion style: form explode: false required: false - name: fields[appStoreVersions] in: query description: the fields to include for returned resources of type appStoreVersions schema: type: array items: type: string enum: - platform - versionString - appStoreState - appVersionState - copyright - reviewType - releaseType - earliestReleaseDate - usesIdfa - downloadable - createdDate - app - appStoreVersionLocalizations - build - appStoreVersionPhasedRelease - gameCenterAppVersion - routingAppCoverage - appStoreReviewDetail - appStoreVersionSubmission - appClipDefaultExperience - appStoreVersionExperiments - appStoreVersionExperimentsV2 - customerReviews - alternativeDistributionPackage style: form explode: false required: false - name: fields[actors] in: query description: the fields to include for returned resources of type actors schema: type: array items: type: string enum: - actorType - userFirstName - userLastName - userEmail - apiKeyId style: form explode: false required: false - name: limit in: query description: maximum resources per page schema: type: integer maximum: 200 style: form - name: include in: query description: comma-separated list of relationships to include schema: type: array items: type: string enum: - app - items - appStoreVersionForReview - submittedByActor - lastUpdatedByActor style: form explode: false required: false - name: limit[items] in: query description: maximum number of related items returned (when they are included) schema: type: integer maximum: 50 style: form required: false responses: '400': description: Parameter error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '200': description: List of ReviewSubmissions content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionsResponse' '429': description: Rate limit exceeded error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' summary: List Review Submissions post: tags: - ReviewSubmissions operationId: reviewSubmissions_createInstance requestBody: description: ReviewSubmission representation content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionCreateRequest' required: true responses: '400': description: Parameter error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Unprocessable request entity error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '201': description: Single ReviewSubmission content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionResponse' '409': description: Request entity error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' summary: Create Review Submissions /v1/reviewSubmissions/{id}: parameters: - name: id in: path description: the id of the requested resource schema: type: string style: simple required: true get: tags: - ReviewSubmissions operationId: reviewSubmissions_getInstance parameters: - name: fields[reviewSubmissions] in: query description: the fields to include for returned resources of type reviewSubmissions schema: type: array items: type: string enum: - platform - submittedDate - state - app - items - appStoreVersionForReview - submittedByActor - lastUpdatedByActor style: form explode: false required: false - name: fields[apps] in: query description: the fields to include for returned resources of type apps schema: type: array items: type: string enum: - accessibilityUrl - name - bundleId - sku - primaryLocale - isOrEverWasMadeForKids - subscriptionStatusUrl - subscriptionStatusUrlVersion - subscriptionStatusUrlForSandbox - subscriptionStatusUrlVersionForSandbox - contentRightsDeclaration - streamlinedPurchasingEnabled - accessibilityDeclarations - appEncryptionDeclarations - appStoreIcon - ciProduct - betaTesters - betaGroups - appStoreVersions - appTags - preReleaseVersions - betaAppLocalizations - builds - betaLicenseAgreement - betaAppReviewDetail - appInfos - appClips - appPricePoints - endUserLicenseAgreement - appPriceSchedule - appAvailabilityV2 - inAppPurchases - subscriptionGroups - gameCenterEnabledVersions - perfPowerMetrics - appCustomProductPages - inAppPurchasesV2 - promotedPurchases - appEvents - reviewSubmissions - subscriptionGracePeriod - customerReviews - customerReviewSummarizations - gameCenterDetail - appStoreVersionExperimentsV2 - alternativeDistributionKey - analyticsReportRequests - marketplaceSearchDetail - buildUploads - backgroundAssets - betaFeedbackScreenshotSubmissions - betaFeedbackCrashSubmissions - searchKeywords - webhooks - androidToIosAppMappingDetails style: form explode: false required: false - name: fields[reviewSubmissionItems] in: query description: the fields to include for returned resources of type reviewSubmissionItems schema: type: array items: type: string enum: - state - appStoreVersion - appCustomProductPageVersion - appStoreVersionExperiment - appStoreVersionExperimentV2 - appEvent - backgroundAssetVersion - gameCenterAchievementVersion - gameCenterActivityVersion - gameCenterChallengeVersion - gameCenterLeaderboardSetVersion - gameCenterLeaderboardVersion style: form explode: false required: false - name: fields[appStoreVersions] in: query description: the fields to include for returned resources of type appStoreVersions schema: type: array items: type: string enum: - platform - versionString - appStoreState - appVersionState - copyright - reviewType - releaseType - earliestReleaseDate - usesIdfa - downloadable - createdDate - app - appStoreVersionLocalizations - build - appStoreVersionPhasedRelease - gameCenterAppVersion - routingAppCoverage - appStoreReviewDetail - appStoreVersionSubmission - appClipDefaultExperience - appStoreVersionExperiments - appStoreVersionExperimentsV2 - customerReviews - alternativeDistributionPackage style: form explode: false required: false - name: fields[actors] in: query description: the fields to include for returned resources of type actors schema: type: array items: type: string enum: - actorType - userFirstName - userLastName - userEmail - apiKeyId style: form explode: false required: false - name: include in: query description: comma-separated list of relationships to include schema: type: array items: type: string enum: - app - items - appStoreVersionForReview - submittedByActor - lastUpdatedByActor style: form explode: false required: false - name: limit[items] in: query description: maximum number of related items returned (when they are included) schema: type: integer maximum: 50 style: form required: false responses: '400': description: Parameter error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '200': description: Single ReviewSubmission content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionResponse' '429': description: Rate limit exceeded error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' summary: Get Review Submissions patch: tags: - ReviewSubmissions operationId: reviewSubmissions_updateInstance requestBody: description: ReviewSubmission representation content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionUpdateRequest' required: true responses: '400': description: Parameter error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Unprocessable request entity error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '200': description: Single ReviewSubmission content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionResponse' '409': description: Request entity error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' summary: Update Review Submissions /v1/reviewSubmissions/{id}/relationships/items: parameters: - name: id in: path description: the id of the requested resource schema: type: string style: simple required: true get: tags: - ReviewSubmissions operationId: reviewSubmissions_items_getToManyRelationship parameters: - name: limit in: query description: maximum resources per page schema: type: integer maximum: 200 style: form responses: '400': description: Parameter error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '200': description: List of related linkages content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionItemsLinkagesResponse' '429': description: Rate limit exceeded error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' summary: List Related Review Submissions / Items /v1/reviewSubmissions/{id}/items: parameters: - name: id in: path description: the id of the requested resource schema: type: string style: simple required: true get: tags: - ReviewSubmissions operationId: reviewSubmissions_items_getToManyRelated parameters: - name: fields[reviewSubmissionItems] in: query description: the fields to include for returned resources of type reviewSubmissionItems schema: type: array items: type: string enum: - state - appStoreVersion - appCustomProductPageVersion - appStoreVersionExperiment - appStoreVersionExperimentV2 - appEvent - backgroundAssetVersion - gameCenterAchievementVersion - gameCenterActivityVersion - gameCenterChallengeVersion - gameCenterLeaderboardSetVersion - gameCenterLeaderboardVersion style: form explode: false - name: fields[appStoreVersions] in: query description: the fields to include for returned resources of type appStoreVersions schema: type: array items: type: string enum: - platform - versionString - appStoreState - appVersionState - copyright - reviewType - releaseType - earliestReleaseDate - usesIdfa - downloadable - createdDate - app - appStoreVersionLocalizations - build - appStoreVersionPhasedRelease - gameCenterAppVersion - routingAppCoverage - appStoreReviewDetail - appStoreVersionSubmission - appClipDefaultExperience - appStoreVersionExperiments - appStoreVersionExperimentsV2 - customerReviews - alternativeDistributionPackage style: form explode: false - name: fields[appCustomProductPageVersions] in: query description: the fields to include for returned resources of type appCustomProductPageVersions schema: type: array items: type: string enum: - version - state - deepLink - appCustomProductPage - appCustomProductPageLocalizations style: form explode: false - name: fields[appStoreVersionExperiments] in: query description: the fields to include for returned resources of type appStoreVersionExperiments schema: type: array items: type: string enum: - name - trafficProportion - state - reviewRequired - startDate - endDate - appStoreVersion - appStoreVersionExperimentTreatments - platform - app - latestControlVersion - controlVersions style: form explode: false - name: fields[appEvents] in: query description: the fields to include for returned resources of type appEvents schema: type: array items: type: string enum: - referenceName - badge - eventState - deepLink - purchaseRequirement - primaryLocale - priority - purpose - territorySchedules - archivedTerritorySchedules - localizations style: form explode: false - name: fields[backgroundAssetVersions] in: query description: the fields to include for returned resources of type backgroundAssetVersions schema: type: array items: type: string enum: - createdDate - platforms - state - stateDetails - version - backgroundAsset - internalBetaRelease - externalBetaRelease - appStoreRelease - assetFile - manifestFile - backgroundAssetUploadFiles style: form explode: false - name: fields[gameCenterAchievementVersions] in: query description: the fields to include for returned resources of type gameCenterAchievementVersions schema: type: array items: type: string enum: - version - state - achievement - localizations style: form explode: false - name: fields[gameCenterActivityVersions] in: query description: the fields to include for returned resources of type gameCenterActivityVersions schema: type: array items: type: string enum: - version - state - fallbackUrl - activity - localizations - defaultImage - releases style: form explode: false - name: fields[gameCenterChallengeVersions] in: query description: the fields to include for returned resources of type gameCenterChallengeVersions schema: type: array items: type: string enum: - version - state - challenge - localizations - releases - defaultImage style: form explode: false - name: fields[gameCenterLeaderboardSetVersions] in: query description: the fields to include for returned resources of type gameCenterLeaderboardSetVersions schema: type: array items: type: string enum: - version - state - leaderboardSet - localizations style: form explode: false - name: fields[gameCenterLeaderboardVersions] in: query description: the fields to include for returned resources of type gameCenterLeaderboardVersions schema: type: array items: type: string enum: - version - state - leaderboard - localizations style: form explode: false - name: limit in: query description: maximum resources per page schema: type: integer maximum: 200 style: form - name: include in: query description: comma-separated list of relationships to include schema: type: array items: type: string enum: - appStoreVersion - appCustomProductPageVersion - appStoreVersionExperiment - appStoreVersionExperimentV2 - appEvent - backgroundAssetVersion - gameCenterAchievementVersion - gameCenterActivityVersion - gameCenterChallengeVersion - gameCenterLeaderboardSetVersion - gameCenterLeaderboardVersion style: form explode: false responses: '400': description: Parameter error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized error(s) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '200': description: List of ReviewSubmissionItems content: application/json: schema: $ref: '#/components/schemas/ReviewSubmissionItemsResponse' '429': description: Rate limit exceeded error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' summary: List Related Review Submissions / Items components: schemas: ReviewSubmissionCreateRequest: type: object title: ReviewSubmissionCreateRequest properties: data: type: object properties: type: type: string enum: - reviewSubmissions attributes: type: object properties: platform: nullable: true $ref: '#/components/schemas/Platform' relationships: type: object properties: app: type: object properties: data: type: object properties: type: type: string enum: - apps id: type: string required: - id - type required: - data required: - app required: - relationships - type required: - data PagedDocumentLinks: type: object properties: self: type: string format: uri-reference first: type: string format: uri-reference next: type: string format: uri-reference required: - self ResourceLinks: type: object properties: self: type: string format: uri-reference ReviewSubmissionsResponse: type: object title: ReviewSubmissionsResponse properties: data: type: array items: $ref: '#/components/schemas/ReviewSubmission' included: type: array items: oneOf: - $ref: '#/components/schemas/Actor' - $ref: '#/components/schemas/AppStoreVersion' - $ref: '#/components/schemas/App' - $ref: '#/components/schemas/ReviewSubmissionItem' discriminator: propertyName: type mapping: actors: '#/components/schemas/Actor' reviewSubmissionItems: '#/components/schemas/ReviewSubmissionItem' appStoreVersions: '#/components/schemas/AppStoreVersion' apps: '#/components/schemas/App' links: $ref: '#/components/schemas/PagedDocumentLinks' meta: $ref: '#/components/schemas/PagingInformation' required: - data - links ErrorSourceParameter: type: object title: Parameter properties: parameter: type: string required: - parameter ErrorLinks: type: object properties: about: type: string format: uri-reference associated: oneOf: - type: string format: uri-reference - type: object properties: href: type: string format: uri-reference meta: type: object properties: source: type: string StateDetail: type: object properties: code: type: string description: type: string GameCenterVersionState: type: string enum: - PREPARE_FOR_SUBMISSION - READY_FOR_REVIEW - WAITING_FOR_REVIEW - IN_REVIEW - DEVELOPER_REJECTED - REJECTED - ACCEPTED - PENDING_RELEASE - LIVE - REPLACED_WITH_NEW_VERSION AppVersionState: type: string enum: - ACCEPTED - DEVELOPER_REJECTED - IN_REVIEW - INVALID_BINARY - METADATA_REJECTED - PENDING_APPLE_RELEASE - PENDING_DEVELOPER_RELEASE - PREPARE_FOR_SUBMISSION - PROCESSING_FOR_DISTRIBUTION - READY_FOR_DISTRIBUTION - READY_FOR_REVIEW - REJECTED - REPLACED_WITH_NEW_VERSION - WAITING_FOR_EXPORT_COMPLIANCE - WAITING_FOR_REVIEW AppEvent: type: object title: AppEvent properties: type: type: string enum: - appEvents id: type: string attributes: type: object properties: referenceName: type: string badge: type: string enum: - LIVE_EVENT - PREMIERE - CHALLENGE - COMPETITION - NEW_SEASON - MAJOR_UPDATE - SPECIAL_EVENT eventState: type: string enum: - DRAFT - READY_FOR_REVIEW - WAITING_FOR_REVIEW - IN_REVIEW - REJECTED - ACCEPTED - APPROVED - PUBLISHED - PAST - ARCHIVED deepLink: type: string format: uri purchaseRequirement: type: string primaryLocale: type: string priority: type: string enum: - HIGH - NORMAL purpose: type: string enum: - APPROPRIATE_FOR_ALL_USERS - ATTRACT_NEW_USERS - KEEP_ACTIVE_USERS_INFORMED - BRING_BACK_LAPSED_USERS territorySchedules: type: array items: type: object properties: territories: type: array items: type: string publishStart: type: string format: date-time eventStart: type: string format: date-time eventEnd: type: string format: date-time archivedTerritorySchedules: type: array items: type: object properties: territories: type: array items: type: string publishStart: type: string format: date-time eventStart: type: string format: date-time eventEnd: type: string format: date-time relationships: type: object properties: localizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appEventLocalizations id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type Platform: type: string enum: - IOS - MAC_OS - TV_OS - VISION_OS ReviewSubmissionItemsResponse: type: object title: ReviewSubmissionItemsResponse properties: data: type: array items: $ref: '#/components/schemas/ReviewSubmissionItem' included: type: array items: oneOf: - $ref: '#/components/schemas/AppCustomProductPageVersion' - $ref: '#/components/schemas/AppEvent' - $ref: '#/components/schemas/AppStoreVersionExperiment' - $ref: '#/components/schemas/AppStoreVersion' - $ref: '#/components/schemas/BackgroundAssetVersion' - $ref: '#/components/schemas/GameCenterAchievementVersionV2' - $ref: '#/components/schemas/GameCenterActivityVersion' - $ref: '#/components/schemas/GameCenterChallengeVersion' - $ref: '#/components/schemas/GameCenterLeaderboardSetVersionV2' - $ref: '#/components/schemas/GameCenterLeaderboardVersionV2' discriminator: propertyName: type mapping: appEvents: '#/components/schemas/AppEvent' gameCenterAchievementVersions: '#/components/schemas/GameCenterAchievementVersionV2' gameCenterChallengeVersions: '#/components/schemas/GameCenterChallengeVersion' appStoreVersions: '#/components/schemas/AppStoreVersion' appStoreVersionExperiments: '#/components/schemas/AppStoreVersionExperiment' backgroundAssetVersions: '#/components/schemas/BackgroundAssetVersion' gameCenterActivityVersions: '#/components/schemas/GameCenterActivityVersion' gameCenterLeaderboardSetVersions: '#/components/schemas/GameCenterLeaderboardSetVersionV2' appCustomProductPageVersions: '#/components/schemas/AppCustomProductPageVersion' gameCenterLeaderboardVersions: '#/components/schemas/GameCenterLeaderboardVersionV2' links: $ref: '#/components/schemas/PagedDocumentLinks' meta: $ref: '#/components/schemas/PagingInformation' required: - data - links DocumentLinks: type: object properties: self: type: string format: uri-reference required: - self GameCenterAchievementVersionV2: type: object title: GameCenterAchievementVersionV2 properties: type: type: string enum: - gameCenterAchievementVersions id: type: string attributes: type: object properties: version: type: integer state: $ref: '#/components/schemas/GameCenterVersionState' relationships: type: object properties: achievement: type: object properties: data: type: object properties: type: type: string enum: - gameCenterAchievements id: type: string required: - id - type localizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterAchievementLocalizations id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type Actor: type: object title: Actor properties: type: type: string enum: - actors id: type: string attributes: type: object properties: actorType: type: string enum: - USER - API_KEY - XCODE_CLOUD - APPLE userFirstName: type: string userLastName: type: string userEmail: type: string apiKeyId: type: string links: $ref: '#/components/schemas/ResourceLinks' required: - id - type AppCustomProductPageVersion: type: object title: AppCustomProductPageVersion properties: type: type: string enum: - appCustomProductPageVersions id: type: string attributes: type: object properties: version: type: string state: type: string enum: - PREPARE_FOR_SUBMISSION - READY_FOR_REVIEW - WAITING_FOR_REVIEW - IN_REVIEW - ACCEPTED - APPROVED - REPLACED_WITH_NEW_VERSION - REJECTED deepLink: type: string format: uri relationships: type: object properties: appCustomProductPage: type: object properties: data: type: object properties: type: type: string enum: - appCustomProductPages id: type: string required: - id - type appCustomProductPageLocalizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appCustomProductPageLocalizations id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type AppStoreVersionExperiment: type: object title: AppStoreVersionExperiment properties: type: type: string enum: - appStoreVersionExperiments id: type: string attributes: type: object properties: name: type: string trafficProportion: type: integer state: type: string enum: - PREPARE_FOR_SUBMISSION - READY_FOR_REVIEW - WAITING_FOR_REVIEW - IN_REVIEW - ACCEPTED - APPROVED - REJECTED - COMPLETED - STOPPED reviewRequired: type: boolean startDate: type: string format: date-time endDate: type: string format: date-time relationships: type: object properties: appStoreVersion: type: object properties: data: type: object properties: type: type: string enum: - appStoreVersions id: type: string required: - id - type appStoreVersionExperimentTreatments: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appStoreVersionExperimentTreatments id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type deprecated: true ReviewSubmissionUpdateRequest: type: object title: ReviewSubmissionUpdateRequest properties: data: type: object properties: type: type: string enum: - reviewSubmissions id: type: string attributes: type: object properties: platform: nullable: true $ref: '#/components/schemas/Platform' submitted: type: boolean nullable: true canceled: type: boolean nullable: true required: - id - type required: - data ErrorResponse: type: object properties: errors: type: array items: type: object properties: id: type: string status: type: string code: type: string title: type: string detail: type: string source: oneOf: - $ref: '#/components/schemas/ErrorSourcePointer' - $ref: '#/components/schemas/ErrorSourceParameter' links: $ref: '#/components/schemas/ErrorLinks' meta: type: object additionalProperties: {} required: - code - detail - status - title BackgroundAssetVersionState: type: string enum: - AWAITING_UPLOAD - PROCESSING - FAILED - COMPLETE App: type: object title: App properties: type: type: string enum: - apps id: type: string attributes: type: object properties: accessibilityUrl: type: string format: uri name: type: string bundleId: type: string sku: type: string primaryLocale: type: string isOrEverWasMadeForKids: type: boolean subscriptionStatusUrl: type: string format: uri subscriptionStatusUrlVersion: $ref: '#/components/schemas/SubscriptionStatusUrlVersion' subscriptionStatusUrlForSandbox: type: string format: uri subscriptionStatusUrlVersionForSandbox: $ref: '#/components/schemas/SubscriptionStatusUrlVersion' contentRightsDeclaration: type: string enum: - DOES_NOT_USE_THIRD_PARTY_CONTENT - USES_THIRD_PARTY_CONTENT streamlinedPurchasingEnabled: type: boolean relationships: type: object properties: accessibilityDeclarations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' appEncryptionDeclarations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appEncryptionDeclarations id: type: string required: - id - type appStoreIcon: type: object properties: data: type: object properties: type: type: string enum: - buildIcons id: type: string required: - id - type ciProduct: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - ciProducts id: type: string required: - id - type betaTesters: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' betaGroups: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - betaGroups id: type: string required: - id - type appStoreVersions: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appStoreVersions id: type: string required: - id - type appTags: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' preReleaseVersions: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - preReleaseVersions id: type: string required: - id - type betaAppLocalizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - betaAppLocalizations id: type: string required: - id - type builds: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - builds id: type: string required: - id - type betaLicenseAgreement: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - betaLicenseAgreements id: type: string required: - id - type betaAppReviewDetail: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - betaAppReviewDetails id: type: string required: - id - type appInfos: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appInfos id: type: string required: - id - type appClips: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appClips id: type: string required: - id - type appPricePoints: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' endUserLicenseAgreement: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - endUserLicenseAgreements id: type: string required: - id - type appPriceSchedule: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' appAvailabilityV2: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' inAppPurchases: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - inAppPurchases id: type: string required: - id - type deprecated: true subscriptionGroups: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - subscriptionGroups id: type: string required: - id - type gameCenterEnabledVersions: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterEnabledVersions id: type: string required: - id - type perfPowerMetrics: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' appCustomProductPages: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appCustomProductPages id: type: string required: - id - type inAppPurchasesV2: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - inAppPurchases id: type: string required: - id - type promotedPurchases: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - promotedPurchases id: type: string required: - id - type appEvents: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appEvents id: type: string required: - id - type reviewSubmissions: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - reviewSubmissions id: type: string required: - id - type subscriptionGracePeriod: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - subscriptionGracePeriods id: type: string required: - id - type customerReviews: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' customerReviewSummarizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' gameCenterDetail: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - gameCenterDetails id: type: string required: - id - type appStoreVersionExperimentsV2: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appStoreVersionExperiments id: type: string required: - id - type alternativeDistributionKey: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' analyticsReportRequests: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' marketplaceSearchDetail: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' buildUploads: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' backgroundAssets: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' betaFeedbackScreenshotSubmissions: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' betaFeedbackCrashSubmissions: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' searchKeywords: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' webhooks: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' androidToIosAppMappingDetails: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - androidToIosAppMappingDetails id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type RelationshipLinks: type: object properties: self: type: string format: uri-reference related: type: string format: uri-reference GameCenterLeaderboardVersionV2: type: object title: GameCenterLeaderboardVersionV2 properties: type: type: string enum: - gameCenterLeaderboardVersions id: type: string attributes: type: object properties: version: type: integer state: $ref: '#/components/schemas/GameCenterVersionState' relationships: type: object properties: leaderboard: type: object properties: data: type: object properties: type: type: string enum: - gameCenterLeaderboards id: type: string required: - id - type localizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterLeaderboardLocalizations id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type SubscriptionStatusUrlVersion: type: string enum: - V1 - V2 ReviewSubmissionItemsLinkagesResponse: type: object properties: data: type: array items: type: object properties: type: type: string enum: - reviewSubmissionItems id: type: string required: - id - type links: $ref: '#/components/schemas/PagedDocumentLinks' meta: $ref: '#/components/schemas/PagingInformation' required: - data - links ReviewSubmissionItem: type: object title: ReviewSubmissionItem properties: type: type: string enum: - reviewSubmissionItems id: type: string attributes: type: object properties: state: type: string enum: - READY_FOR_REVIEW - ACCEPTED - APPROVED - REJECTED - REMOVED relationships: type: object properties: appStoreVersion: type: object properties: data: type: object properties: type: type: string enum: - appStoreVersions id: type: string required: - id - type appCustomProductPageVersion: type: object properties: data: type: object properties: type: type: string enum: - appCustomProductPageVersions id: type: string required: - id - type appStoreVersionExperiment: type: object properties: data: type: object properties: type: type: string enum: - appStoreVersionExperiments id: type: string required: - id - type appStoreVersionExperimentV2: type: object properties: data: type: object properties: type: type: string enum: - appStoreVersionExperiments id: type: string required: - id - type appEvent: type: object properties: data: type: object properties: type: type: string enum: - appEvents id: type: string required: - id - type backgroundAssetVersion: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssetVersions id: type: string required: - id - type gameCenterAchievementVersion: type: object properties: data: type: object properties: type: type: string enum: - gameCenterAchievementVersions id: type: string required: - id - type gameCenterActivityVersion: type: object properties: data: type: object properties: type: type: string enum: - gameCenterActivityVersions id: type: string required: - id - type gameCenterChallengeVersion: type: object properties: data: type: object properties: type: type: string enum: - gameCenterChallengeVersions id: type: string required: - id - type gameCenterLeaderboardSetVersion: type: object properties: data: type: object properties: type: type: string enum: - gameCenterLeaderboardSetVersions id: type: string required: - id - type gameCenterLeaderboardVersion: type: object properties: data: type: object properties: type: type: string enum: - gameCenterLeaderboardVersions id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type AppStoreVersion: type: object title: AppStoreVersion properties: type: type: string enum: - appStoreVersions id: type: string attributes: type: object properties: platform: $ref: '#/components/schemas/Platform' versionString: type: string appStoreState: deprecated: true $ref: '#/components/schemas/AppStoreVersionState' appVersionState: $ref: '#/components/schemas/AppVersionState' copyright: type: string reviewType: type: string enum: - APP_STORE - NOTARIZATION releaseType: type: string enum: - MANUAL - AFTER_APPROVAL - SCHEDULED earliestReleaseDate: type: string format: date-time usesIdfa: type: boolean deprecated: true downloadable: type: boolean createdDate: type: string format: date-time relationships: type: object properties: app: type: object properties: data: type: object properties: type: type: string enum: - apps id: type: string required: - id - type appStoreVersionLocalizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appStoreVersionLocalizations id: type: string required: - id - type build: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - builds id: type: string required: - id - type appStoreVersionPhasedRelease: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - appStoreVersionPhasedReleases id: type: string required: - id - type gameCenterAppVersion: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - gameCenterAppVersions id: type: string required: - id - type routingAppCoverage: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - routingAppCoverages id: type: string required: - id - type appStoreReviewDetail: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - appStoreReviewDetails id: type: string required: - id - type appStoreVersionSubmission: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - appStoreVersionSubmissions id: type: string required: - id - type appClipDefaultExperience: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - appClipDefaultExperiences id: type: string required: - id - type appStoreVersionExperiments: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appStoreVersionExperiments id: type: string required: - id - type appStoreVersionExperimentsV2: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - appStoreVersionExperiments id: type: string required: - id - type customerReviews: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' alternativeDistributionPackage: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - alternativeDistributionPackages id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type BackgroundAssetVersion: type: object title: BackgroundAssetVersion properties: type: type: string enum: - backgroundAssetVersions id: type: string attributes: type: object properties: createdDate: type: string format: date-time platforms: type: array items: $ref: '#/components/schemas/Platform' state: $ref: '#/components/schemas/BackgroundAssetVersionState' stateDetails: type: object properties: errors: type: array items: $ref: '#/components/schemas/StateDetail' warnings: type: array items: $ref: '#/components/schemas/StateDetail' infos: type: array items: $ref: '#/components/schemas/StateDetail' version: type: string relationships: type: object properties: backgroundAsset: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssets id: type: string required: - id - type internalBetaRelease: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssetVersionInternalBetaReleases id: type: string required: - id - type externalBetaRelease: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssetVersionExternalBetaReleases id: type: string required: - id - type appStoreRelease: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssetVersionAppStoreReleases id: type: string required: - id - type assetFile: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssetUploadFiles id: type: string required: - id - type manifestFile: type: object properties: data: type: object properties: type: type: string enum: - backgroundAssetUploadFiles id: type: string required: - id - type backgroundAssetUploadFiles: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' links: $ref: '#/components/schemas/ResourceLinks' required: - id - type ErrorSourcePointer: type: object title: JsonPointer properties: pointer: type: string required: - pointer GameCenterChallengeVersion: type: object title: GameCenterChallengeVersion properties: type: type: string enum: - gameCenterChallengeVersions id: type: string attributes: type: object properties: version: type: integer state: $ref: '#/components/schemas/GameCenterVersionState' relationships: type: object properties: challenge: type: object properties: data: type: object properties: type: type: string enum: - gameCenterChallenges id: type: string required: - id - type localizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterChallengeLocalizations id: type: string required: - id - type releases: type: object properties: meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterChallengeVersionReleases id: type: string required: - id - type defaultImage: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - gameCenterChallengeImages id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type PagingInformation: type: object properties: paging: type: object properties: total: type: integer limit: type: integer nextCursor: type: string required: - limit required: - paging ReviewSubmission: type: object title: ReviewSubmission properties: type: type: string enum: - reviewSubmissions id: type: string attributes: type: object properties: platform: $ref: '#/components/schemas/Platform' submittedDate: type: string format: date-time state: type: string enum: - READY_FOR_REVIEW - WAITING_FOR_REVIEW - IN_REVIEW - UNRESOLVED_ISSUES - CANCELING - COMPLETING - COMPLETE relationships: type: object properties: app: type: object properties: data: type: object properties: type: type: string enum: - apps id: type: string required: - id - type items: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - reviewSubmissionItems id: type: string required: - id - type appStoreVersionForReview: type: object properties: data: type: object properties: type: type: string enum: - appStoreVersions id: type: string required: - id - type submittedByActor: type: object properties: data: type: object properties: type: type: string enum: - actors id: type: string required: - id - type lastUpdatedByActor: type: object properties: data: type: object properties: type: type: string enum: - actors id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type GameCenterActivityVersion: type: object title: GameCenterActivityVersion properties: type: type: string enum: - gameCenterActivityVersions id: type: string attributes: type: object properties: version: type: integer state: $ref: '#/components/schemas/GameCenterVersionState' fallbackUrl: type: string relationships: type: object properties: activity: type: object properties: data: type: object properties: type: type: string enum: - gameCenterActivities id: type: string required: - id - type localizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterActivityLocalizations id: type: string required: - id - type defaultImage: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' data: type: object properties: type: type: string enum: - gameCenterActivityImages id: type: string required: - id - type releases: type: object properties: meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterActivityVersionReleases id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type AppStoreVersionState: type: string enum: - ACCEPTED - DEVELOPER_REMOVED_FROM_SALE - DEVELOPER_REJECTED - IN_REVIEW - INVALID_BINARY - METADATA_REJECTED - PENDING_APPLE_RELEASE - PENDING_CONTRACT - PENDING_DEVELOPER_RELEASE - PREPARE_FOR_SUBMISSION - PREORDER_READY_FOR_SALE - PROCESSING_FOR_APP_STORE - READY_FOR_REVIEW - READY_FOR_SALE - REJECTED - REMOVED_FROM_SALE - WAITING_FOR_EXPORT_COMPLIANCE - WAITING_FOR_REVIEW - REPLACED_WITH_NEW_VERSION - NOT_APPLICABLE GameCenterLeaderboardSetVersionV2: type: object title: GameCenterLeaderboardSetVersionV2 properties: type: type: string enum: - gameCenterLeaderboardSetVersions id: type: string attributes: type: object properties: version: type: integer state: $ref: '#/components/schemas/GameCenterVersionState' relationships: type: object properties: leaderboardSet: type: object properties: data: type: object properties: type: type: string enum: - gameCenterLeaderboardSets id: type: string required: - id - type localizations: type: object properties: links: $ref: '#/components/schemas/RelationshipLinks' meta: $ref: '#/components/schemas/PagingInformation' data: type: array items: type: object properties: type: type: string enum: - gameCenterLeaderboardSetLocalizations id: type: string required: - id - type links: $ref: '#/components/schemas/ResourceLinks' required: - id - type ReviewSubmissionResponse: type: object title: ReviewSubmissionResponse properties: data: $ref: '#/components/schemas/ReviewSubmission' included: type: array items: oneOf: - $ref: '#/components/schemas/Actor' - $ref: '#/components/schemas/AppStoreVersion' - $ref: '#/components/schemas/App' - $ref: '#/components/schemas/ReviewSubmissionItem' discriminator: propertyName: type mapping: actors: '#/components/schemas/Actor' reviewSubmissionItems: '#/components/schemas/ReviewSubmissionItem' appStoreVersions: '#/components/schemas/AppStoreVersion' apps: '#/components/schemas/App' links: $ref: '#/components/schemas/DocumentLinks' required: - data - links securitySchemes: itc-bearer-token: type: http scheme: bearer bearerFormat: JWT