iOS

iOS Nominations API

The Nominations API from iOS — 2 operation(s) for nominations.

Documentation GitHub OpenAPI

Operations 5

GET /v1/nominations List Nominations #

POST /v1/nominations Create Nominations #

GET /v1/nominations/{id} Get Nominations #

PATCH /v1/nominations/{id} Update Nominations #

DELETE /v1/nominations/{id} Delete Nominations #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/ios-nominations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: App Store Connect AccessibilityDeclarations Nominations 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: Nominations
paths:
  /v1/nominations:
    get:
      tags:
      - Nominations
      operationId: nominations_getCollection
      parameters:
      - name: filter[type]
        in: query
        description: filter by attribute 'type'
        schema:
          type: array
          items:
            type: string
            enum:
            - APP_LAUNCH
            - APP_ENHANCEMENTS
            - NEW_CONTENT
        style: form
        explode: false
        required: false
      - name: filter[state]
        in: query
        description: filter by attribute 'state'
        schema:
          type: array
          items:
            type: string
            enum:
            - DRAFT
            - SUBMITTED
            - ARCHIVED
        style: form
        explode: false
        required: true
      - name: filter[hasInAppEvents]
        in: query
        description: filter by attribute 'hasInAppEvents'
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: filter[relatedApps]
        in: query
        description: filter by id(s) of related 'relatedApps'
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: sort
        in: query
        description: comma-separated list of sort expressions; resources will be sorted as specified
        schema:
          type: array
          items:
            type: string
            enum:
            - lastModifiedDate
            - -lastModifiedDate
            - publishStartDate
            - -publishStartDate
            - publishEndDate
            - -publishEndDate
            - name
            - -name
            - type
            - -type
        style: form
        explode: false
        required: false
      - name: fields[nominations]
        in: query
        description: the fields to include for returned resources of type nominations
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - type
            - description
            - createdDate
            - lastModifiedDate
            - submittedDate
            - state
            - publishStartDate
            - publishEndDate
            - deviceFamilies
            - locales
            - supplementalMaterialsUris
            - hasInAppEvents
            - launchInSelectMarketsFirst
            - notes
            - preOrderEnabled
            - relatedApps
            - createdByActor
            - lastModifiedByActor
            - submittedByActor
            - inAppEvents
            - supportedTerritories
        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[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: 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
        required: false
      - name: fields[territories]
        in: query
        description: the fields to include for returned resources of type territories
        schema:
          type: array
          items:
            type: string
            enum:
            - currency
        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:
            - relatedApps
            - createdByActor
            - lastModifiedByActor
            - submittedByActor
            - inAppEvents
            - supportedTerritories
        style: form
        explode: false
        required: false
      - name: limit[inAppEvents]
        in: query
        description: maximum number of related inAppEvents returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[relatedApps]
        in: query
        description: maximum number of related relatedApps returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[supportedTerritories]
        in: query
        description: maximum number of related supportedTerritories returned (when they are included)
        schema:
          type: integer
          maximum: 200
        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 Nominations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationsResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/csv'
        '429':
          description: Rate limit exceeded error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: List Nominations
    post:
      tags:
      - Nominations
      operationId: nominations_createInstance
      requestBody:
        description: Nomination representation
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NominationCreateRequest'
        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 Nomination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationResponse'
        '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 Nominations
  /v1/nominations/{id}:
    parameters:
    - name: id
      in: path
      description: the id of the requested resource
      schema:
        type: string
      style: simple
      required: true
    get:
      tags:
      - Nominations
      operationId: nominations_getInstance
      parameters:
      - name: fields[nominations]
        in: query
        description: the fields to include for returned resources of type nominations
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - type
            - description
            - createdDate
            - lastModifiedDate
            - submittedDate
            - state
            - publishStartDate
            - publishEndDate
            - deviceFamilies
            - locales
            - supplementalMaterialsUris
            - hasInAppEvents
            - launchInSelectMarketsFirst
            - notes
            - preOrderEnabled
            - relatedApps
            - createdByActor
            - lastModifiedByActor
            - submittedByActor
            - inAppEvents
            - supportedTerritories
        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[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: 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
        required: false
      - name: fields[territories]
        in: query
        description: the fields to include for returned resources of type territories
        schema:
          type: array
          items:
            type: string
            enum:
            - currency
        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:
            - relatedApps
            - createdByActor
            - lastModifiedByActor
            - submittedByActor
            - inAppEvents
            - supportedTerritories
        style: form
        explode: false
        required: false
      - name: limit[inAppEvents]
        in: query
        description: maximum number of related inAppEvents returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[relatedApps]
        in: query
        description: maximum number of related relatedApps returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[supportedTerritories]
        in: query
        description: maximum number of related supportedTerritories returned (when they are included)
        schema:
          type: integer
          maximum: 200
        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 Nomination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationResponse'
        '429':
          description: Rate limit exceeded error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Get Nominations
    patch:
      tags:
      - Nominations
      operationId: nominations_updateInstance
      requestBody:
        description: Nomination representation
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NominationUpdateRequest'
        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 Nomination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationResponse'
        '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 Nominations
    delete:
      tags:
      - Nominations
      operationId: nominations_deleteInstance
      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'
        '204':
          description: Success (no content)
        '429':
          description: Rate limit exceeded error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Delete Nominations
components:
  schemas:
    Territory:
      type: object
      title: Territory
      properties:
        type:
          type: string
          enum:
          - territories
        id:
          type: string
        attributes:
          type: object
          properties:
            currency:
              type: string
        links:
          $ref: '#/components/schemas/ResourceLinks'
      required:
      - id
      - type
    csv:
      type: string
    NominationCreateRequest:
      type: object
      title: NominationCreateRequest
      properties:
        data:
          type: object
          properties:
            type:
              type: string
              enum:
              - nominations
            attributes:
              type: object
              properties:
                name:
                  type: string
                type:
                  type: string
                  enum:
                  - APP_LAUNCH
                  - APP_ENHANCEMENTS
                  - NEW_CONTENT
                description:
                  type: string
                submitted:
                  type: boolean
                publishStartDate:
                  type: string
                  format: date-time
                publishEndDate:
                  type:
                  - string
                  - 'null'
                  format: date-time
                deviceFamilies:
                  type:
                  - array
                  - 'null'
                  items:
                    $ref: '#/components/schemas/DeviceFamily'
                locales:
                  type:
                  - array
                  - 'null'
                  items:
                    type: string
                supplementalMaterialsUris:
                  type:
                  - array
                  - 'null'
                  items:
                    type: string
                    format: uri
                hasInAppEvents:
                  type:
                  - boolean
                  - 'null'
                launchInSelectMarketsFirst:
                  type:
                  - boolean
                  - 'null'
                notes:
                  type:
                  - string
                  - 'null'
                preOrderEnabled:
                  type:
                  - boolean
                  - 'null'
              required:
              - submitted
              - publishStartDate
              - name
              - description
              - type
            relationships:
              type: object
              properties:
                relatedApps:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                            - apps
                          id:
                            type: string
                        required:
                        - id
                        - type
                  required:
                  - data
                inAppEvents:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                            - appEvents
                          id:
                            type: string
                        required:
                        - id
                        - type
                supportedTerritories:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                            - territories
                          id:
                            type: string
                        required:
                        - id
                        - type
              required:
              - relatedApps
          required:
          - relationships
          - attributes
          - type
      required:
      - data
    NominationResponse:
      type: object
      title: NominationResponse
      properties:
        data:
          $ref: '#/components/schemas/Nomination'
        included:
          type: array
          items:
            oneOf:
            - $ref: '#/components/schemas/Actor'
            - $ref: '#/components/schemas/AppEvent'
            - $ref: '#/components/schemas/App'
            - $ref: '#/components/schemas/Territory'
            discriminator:
              propertyName: type
              mapping:
                actors: '#/components/schemas/Actor'
                appEvents: '#/components/schemas/AppEvent'
                territories: '#/components/schemas/Territory'
                apps: '#/components/schemas/App'
        links:
          $ref: '#/components/schemas/DocumentLinks'
      required:
      - data
      - links
    SubscriptionStatusUrlVersion:
      type: string
      enum:
      - V1
      - V2
    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
    NominationUpdateRequest:
      type: object
      title: NominationUpdateRequest
      properties:
        data:
          type: object
          properties:
            type:
              type: string
              enum:
              - nominations
            id:
              type: string
            attributes:
              type: object
              properties:
                name:
                  type:
                  - string
                  - 'null'
                type:
                  type:
                  - string
                  - 'null'
                  enum:
                  - APP_LAUNCH
                  - APP_ENHANCEMENTS
                  - NEW_CONTENT
                description:
                  type:
                  - string
                  - 'null'
                submitted:
                  type:
                  - boolean
                  - 'null'
                archived:
                  type:
                  - boolean
                  - 'null'
                publishStartDate:
                  type:
                  - string
                  - 'null'
                  format: date-time
                publishEndDate:
                  type:
                  - string
                  - 'null'
                  format: date-time
                deviceFamilies:
                  type:
                  - array
                  - 'null'
                  items:
                    $ref: '#/components/schemas/DeviceFamily'
                locales:
                  type:
                  - array
                  - 'null'
                  items:
                    type: string
                supplementalMaterialsUris:
                  type:
                  - array
                  - 'null'
                  items:
                    type: string
                    format: uri
                hasInAppEvents:
                  type:
                  - boolean
                  - 'null'
                launchInSelectMarketsFirst:
                  type:
                  - boolean
                  - 'null'
                notes:
                  type:
                  - string
                  - 'null'
                preOrderEnabled:
                  type:
                  - boolean
                  - 'null'
            relationships:
              type: object
              properties:
                relatedApps:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                            - apps
                          id:
                            type: string
                        required:
                        - id
                        - type
                inAppEvents:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                            - appEvents
                          id:
                            type: string
                        required:
                        - id
                        - type
                supportedTerritories:
                  type: object
                  properties:
                    data:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                            - territories
                          id:
                            type: string
                        required:
                        - id
                        - type
          required:
          - id
          - type
      required:
      - data
    Nomination:
      type: object
      title: Nomination
      properties:
        type:
          type: string
          enum:
          - nominations
        id:
          type: string
        attributes:
          type: object
          properties:
            name:
              type: string
            type:
              type: string
              enum:
              - APP_LAUNCH
              - APP_ENHANCEMENTS
              - NEW_CONTENT
            description:
              type: string
            createdDate:
              type: string
              format: date-time
            lastModifiedDate:
              type: string
              format: date-time
            submittedDate:
              type: string
              format: date-time
          

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-nominations-api-openapi.yml