Site

Configuration about the site.

Categories

Note

The URL for this API will be moving.

GET /api/v1/apps/category/

Returns a list of categories available on the marketplace.

Request

Standard Listing query params.

Response

Parameters:
Status Codes:
  • 200 – successfully completed.
GET /api/v1/apps/category/(int: id)/

Returns a category.

Response

{
    "id": 1,
    "name": "Games",
    "resource_uri": "/api/v1/apps/category/1/",
    "slug": "games"
}

Carriers

GET /api/v1/services/carrier/

Returns a list of possible carriers for apps.

Response

Parameters:
Status Codes:
  • 200 – successfully completed.
GET /api/v1/services/carrier/<slug>/

Returns a carrier.

Request

Standard Listing query params.

Response

{
    "id": "1",
    "name": "PhoneORama",
    "resource_uri": "/api/v1/services/carrier/phoneorama/",
    "slug": "phoneorama"
}

Regions

GET /api/v1/services/region/

Returns a list of possible regions for apps.

Response

Parameters:
Status Codes:
  • 200 – successfully completed.
GET /api/v1/services/region/<slug>/

Returns a region.

Request

Standard Listing query params.

Response

{
    "id": "1",
    "name": "Appistan",
    "resource_uri": "/api/v1/services/region/ap/",
    "slug": "ap",
    "default_currency": "USD",
    "default_language": "en-AP",
}

Configuration

GET /api/v1/services/config/site/

Returns information about how the marketplace is configured. Not all settings and configuration options are returned - only a subset. This subset will change as features in the site change. The list of results should not be relied upon to stay consistent.

Response

Parameters:
  • version (string|null) – the git commit number of the deployment.
  • settings (object) – a subset of useful site settings.
  • flags (object) – a subset of useful runtime configuration settings.

Example:

{
    "flags": {
        "allow-b2g-paid-submission": true,
        "allow-refund": true,
        "in-app-sandbox": false
    },
    "resource_uri": "",
    "settings": {
        "SITE_URL": "http://z.mozilla.dev"
    },
    "version": null
}