GET /connections/{id}/listings

App Store name/subtitle/description/keywords/what's new need a version in Prepare for Submission; promotional text is editable on the live version. Play fields are always editable.

Request

curl "https://api.appgoat.ai/v1/connections/123/listings?app=value" \
  -H "x-api-key: $APPGOAT_API_KEY"

const res = await fetch("https://api.appgoat.ai/v1/connections/123/listings?app=value", {
  headers: {
    "x-api-key": process.env.APPGOAT_API_KEY,
  },
});
const { data, meta } = await res.json();

import os, requests

res = requests.get(
    "https://api.appgoat.ai/v1/connections/123/listings?app=value",
    headers={"x-api-key": os.environ["APPGOAT_API_KEY"]}
)
body = res.json()

Response

200 with data: Listing. See the envelope for meta.

appstring

localestring

fieldsobject

editablestring[]

notesstring[]

versionstring | null

version_statestring | null

Example

{
  "data": {
    "app": "string",
    "locale": "string",
    "fields": {},
    "editable": [
      "string"
    ],
    "notes": [
      "string"
    ],
    "version": "string",
    "version_state": "string"
  },
  "meta": {
    "credits_used": 1,
    "credits_remaining": 9981,
    "request_id": "req_123"
  }
}

Status codes

200

The listing.

401invalid_api_key

Missing or invalid API key.

402insufficient_creditsplan_limit

insufficient_credits (the call costs more than you have left; nothing was done) or plan_limit (a feature of a higher plan).

404not_found

Not found.

429rate_limited

Too many requests per second for your plan.

502