Retrieve Runway API accounts configuration

August 8, 2024 (November 16, 2026)

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

For your convenience, you can specify your Runway configuration values under your Runway account. If you specify multiple Runway accounts, the API will automatically perform load balancing by randomly selecting an account with available capacity before making calls to Runway.

This endpoint retrieves the complete list of configured API accounts for Runway.

https://api.useapi.net/v1/runwayml/accounts

Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
Responses
  • 200 OK

    {
        "user-1@example.com": {
            "email": "user-1@example.com",
            "password": "…secured…"
            "jwt": {
                "token": "eyJ…secured…Xk9",
                "exp": 1734858598.864,
                "iat": 1732266598.864,
                "id": 123456,
            },
            "maxJobs": 5,
            "workspace": {
                "id": 654321,
                "name": "Team workspace",
                "plan": "unlimited-monthly",
                "auto": true
            },
        },
        "user-N@example.com": {
            "email": "user-N@example.com",
            "password": "…secured…"
            "jwt": {
                "token": "eyJ…secured…Xk9",
                "exp": 1744858598.864,
                "iat": 1742266598.864,
                "id": 78910,
            },
            "maxJobs": 5,
        }
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
  • 404 Not Found

    Configuration not found. To create configuration use POST /accounts/email.

Model

An object keyed by account email, each value with that account’s maxJobs, masked session token and workspace when one is set.

The account configurations, keyed by email, field by field
{ // TypeScript, all fields are optional
  [email: string]: {
    email: string,
    password: string, // always "…secured…"
    maxJobs: number,
    workspace: {
      id: number,
      name: string,
      plan: string,
      auto: boolean,
    }
    jwt: {
      token: string, // masked: first and last 3 characters
      exp: number,
      iat: number,
      id: number,
    }
  }
}
Examples
  • curl https://api.useapi.net/v1/runwayml/accounts \
       -H "Accept: application/json" \
       -H "Authorization: Bearer …" 
    
  • const token = "API token";
    const apiUrl = "https://api.useapi.net/v1/runwayml/accounts"; 
    const response = await fetch(apiUrl, {
      headers: {
        "Authorization": `Bearer ${token}`,
      },
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    token = "API token"
    apiUrl = "https://api.useapi.net/v1/runwayml/accounts"
    headers = {
        "Content-Type": "application/json", 
        "Authorization" : f"Bearer {token}"
    }
    response = requests.get(apiUrl, headers=headers)
    print(response, response.json())
    
Try It