Sample - GitHub REST API
GET/marketplace_listing/plans

List plans

Lists all plans that are part of your GitHub Marketplace listing.

GitHub Apps must use a JWT to access this endpoint. OAuth apps must use basic authentication with their client ID and client secret to access this endpoint.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
per_pageintegeroptional
The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Default:30
pageintegeroptional
The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Default:1

3 status codes
200Response
urlstringrequired
accounts_urlstringrequired
idintegerrequired
numberintegerrequired
namestringrequired
descriptionstringrequired
monthly_price_in_centsintegerrequired
yearly_price_in_centsintegerrequired
price_modelstringrequired
Allowed:FREEFLAT_RATEPER_UNIT
has_free_trialbooleanrequired
unit_namestringrequired
statestringrequired
bulletsarray<string>required
401Requires authentication
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
404Resource not found
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 401 is returned: Requires authentication. A 404 is returned: Resource not found.