API reference

Users

Read the account behind the API key: which plan it is on, how many credits are left, and the limits that apply to your requests.

#Get current user

Get the authenticated user's profile, credits, subscription and usage.

GEThttps://api.rendley.com/v1/users/me

API key

Don't have one? Create an API key

const res = await fetch("https://api.rendley.com/v1/users/me", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { data } = await res.json();

curl "https://api.rendley.com/v1/users/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

res = requests.get(
    "https://api.rendley.com/v1/users/me",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]

$ch = curl_init("https://api.rendley.com/v1/users/me");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY"]);

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true)["data"];

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.rendley.com/v1/users/me", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	b, _ := io.ReadAll(res.Body)
	fmt.Println(string(b))
}

require "net/http"
require "json"

uri = URI("https://api.rendley.com/v1/users/me")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)["data"]

Response 200

{
  "data": {
    "credits": {
      "balance": 0,
      "purchased_credits": 0,
      "subscription_credits": 0
    },
    "email": "string",
    "id": "3f0d5a4e-3d2a-4c1f-9b3e-2a1c4d5e6f70",
    "name": "string",
    "photo_url": "string",
    "subscription": {
      "auto_reframe": true,
      "billing_interval": "string",
      "brandkit_asset_upload": true,
      "brandkit_font_upload": true,
      "brandkit_logo_limit": 0,
      "brandkit_voice_limit": 0,
      "mcp_agent_max_concurrent": 0,
      "music_seconds": 0,
      "plan_name": "string",
      "plan_variant_id": "3f0d5a4e-3d2a-4c1f-9b3e-2a1c4d5e6f70",
      "projects": 0,
      "social_publishing": true,
      "status": "string",
      "storage_bytes": 0,
      "transcription_seconds": 0,
      "tts_chars": 0,
      "workspaces": 0
    },
    "usage": {
      "music_seconds_used": 0,
      "projects_used": 0,
      "storage_used": 0,
      "transcription_seconds_used": 0,
      "tts_chars_used": 0,
      "workspaces_used": 0
    },
    "usage_meters": [
      {
        "key": "string",
        "limit": 0,
        "reset_at": "string",
        "used": 0
      }
    ]
  }
}