Render API


The Render Public API is a REST API that lets you manage all of your Render services and resources through simple HTTP requests. With this API, you can have all the power of the Render dashboard through your own scripts, allowing you to integrate seamlessly with Render through your own scripts.

Currently, the API supports endpoints that allow for management of services, deploys, custom domains, and jobs. We’ll be gradually releasing more endpoints in the coming months, allowing you to manage databases, environment groups, secret files, metrics, logs, and YAML configurations.

See the API reference for full technical documentation.

Getting Started

To interact with the Render API, you will need to provision an API key from your user account to authenticate every request.

Creating an API Key

To create and view your API keys, go to your personal Account Settings page in the Render dashboard.

Create API keys

The API key will be displayed in full only when it’s created.

API key

Your API key allows you to do anything you would with your Render account's dashboard, so make sure to keep it secure. Don't publicly post your API key, commit it to a public GitHub repo, or otherwise share it with anyone who you wouldn't want control of your Render resources.

Making an API Request

To test your API key, make a sample cURL request to retrieve your services.

Replace {{render_api_token_goes_here}} with your provisioned API key.

curl --request GET \
     --url 'https://api.render.com/v1/services?limit=20' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {{render_api_token_goes_here}}'

If your API key is valid, the GET request should return a 200 response with your services formatted as JSON.

Next Steps

Explore the API reference for a comprehensive list of supported endpoints.

The readme.io API reference is interactive and provides sample request usage for cURL, Node, Python, and more.

API reference on readme.io