caution

The Casting Calls API is in beta/early preview and may undergo changes. If you are interested in using them, please contact our support.

Casting Calls

The Casting Calls endpoint allows you to retrieve information about casting calls, including details about the production, roles, deadlines, and requirements.

Get All Casting Calls

cURL
JavaScript (Fetch)
PHP (cURL)
Ruby (Net::HTTP)

curl "https://www.filmmakers.eu/api/v1/casting_calls" \
  -H "Authorization: Token token=API_KEY"

fetch('https://www.filmmakers.eu/api/v1/casting_calls', {
  method: 'GET',
  headers: {
    'Authorization': 'Token token=API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

<?php
$apiKey = 'API_KEY'; // Replace with your actual API key
$url = "https://www.filmmakers.eu/api/v1/casting_calls";

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Token token=' . $apiKey,
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

require 'net/http'
require 'json'

api_key = 'API_KEY' # Replace with your actual API key
uri = URI('https://www.filmmakers.eu/api/v1/casting_calls')

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Token token=#{api_key}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data

Example Response

[
  { "id": 549, "name": "Project Sunrise" },
  { "id": 548, "name": "The Reality" },
  { "id": 547, "name": "Sunflowers for Happiness" },
  { "id": 546, "name": "Breakdown #4 Sunrise on the Reaping" }
]

This endpoint retrieves all casting calls available with the access rights of the API key. Each object contains the unique ID and name of the casting call.

HTTP Request

GET https://www.filmmakers.eu/api/v1/casting_calls

Query Parameters

Parameter	Default	Description
page	1	Page to display – see "Pagination" section
per_page	250	Items per page – see "Pagination" section
current	false	Set to `true` or `1` to return only casting calls with a current opportunity visible to your API key. Omit this parameter, or pass an empty value, `false`, or `0`, to include both current and expired casting calls.
fields	name	Can be used to limit the fields included in the response. Possible values are: `name`, `casting_type`, `description`, `production_format`, `deadline`, `deadline_visible`. Multiple fields can be specified as a comma-separated list.

Current Casting Calls

To retrieve only current casting calls:

curl "https://www.filmmakers.eu/api/v1/casting_calls?current=true" \
  -H "Authorization: Token token=API_KEY"

The filter uses the same deadline rules as the website's casting opportunities. A casting call is current when at least one active, non-deleted role visible to your API key has no effective deadline or has a deadline at or after the current time. A role's own deadline takes precedence over the casting call's deadline; if the role has no deadline, it inherits the casting call's deadline. If there are no active, non-deleted roles visible to your API key, the casting call's deadline determines whether it is current.

For example, a casting call with an expired overall deadline is still included if a visible active role remains open. Conversely, a future overall deadline does not qualify a casting call whose visible active roles have all expired. For private castings, roles you were not invited to do not affect the result. Deadlines marked as hidden are still used for filtering visible opportunities. Each qualifying casting call appears once, and results remain limited to the API key's existing access rights.

Response Fields

Field	Type	Description
id	integer	Unique ID of the casting call
name	string	Name of the casting call

Get a Specific Casting Call

cURL
JavaScript (Fetch)
PHP (cURL)
Ruby (Net::HTTP)

curl "https://www.filmmakers.eu/api/v1/casting_calls/{id}" \
  -H "Authorization: Token token=API_KEY"

// Replace {id} with the actual casting call ID
fetch('https://www.filmmakers.eu/api/v1/casting_calls/{id}', {
  method: 'GET',
  headers: {
    'Authorization': 'Token token=API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

<?php
$apiKey = 'API_KEY'; // Replace with your actual API key
$castingCallId = '{id}'; // Replace {id} with the actual casting call ID
$url = "https://www.filmmakers.eu/api/v1/casting_calls/" . $castingCallId;

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Token token=' . $apiKey,
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

require 'net/http'
require 'json'

api_key = 'API_KEY' # Replace with your actual API key
casting_call_id = '{id}' # Replace {id} with the actual casting call ID
uri = URI("https://www.filmmakers.eu/api/v1/casting_calls/#{casting_call_id}")

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Token token=#{api_key}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data

Replace {id} with the ID of the casting call you want to retrieve.

Example Response

{
  "id": 549,
  "name": "Project Sunrise - 'Jordan' (lead role)",
  "description": "A coming-of-age drama about resilience and hope.",
  "deadline": "2025-02-25T12:04:00.000+01:00",
  "visibility": "public",
  "deadline_visible": true,
  "production_format": null,
  "casting_type": "ecasting",
  "production_id": 123,
  "working_permits": [],
  "regions": ["dach"],
  "casting_director": {
    "id": 123,
    "name": "Caster ABC"
  },
  "production_locations": [
    {
      "name": "Berlin",
      "country": "DE",
      "longitude": 13.404954,
      "latitude": 52.5200066
    }
  ],
  "filmmakers_url": "https://www.filmmakers.eu/casting_calls/549",
  "created_at": "2025-02-18T13:05:24.865+01:00",
  "updated_at": "2025-02-18T13:05:24.865+01:00",
  "roles": [
    {
      "id": 750,
      "name": "Jordan",
      "description": "A determined teenager facing new challenges.",
      "contract_type": 100004,
      "contract_type_info": "<p>Negotiated fee and usage terms.</p>",
      "deadline": "2025-02-25T12:04:00.000+01:00",
      "gender": ["female"],
      "acting_age_from": 15,
      "acting_age_to": 18,
      "languages": { "eng": "gut" },
      "ethnic_background": [6468, 6471],
      "ethnic_background_details": [],
      "created_at": "2025-02-18T13:05:24.865+01:00",
      "updated_at": "2025-02-18T13:05:24.865+01:00"
    }
  ]
}

This endpoint retrieves a specific casting call by its ID, including all production details and available roles.

note

filmmakers_url points to the Filmmakers web page for the casting call. It does not grant access by itself: the user must be authenticated and authorized on Filmmakers before the page can be opened. Use it as an authenticated redirect target, for example as the redirect_to payload in an SSO login flow.

HTTP Request

GET https://www.filmmakers.eu/api/v1/casting_calls/{id}

Replace {id} with the ID of the casting call you want to retrieve.

Response Fields

Field	Type	Description
id	integer	Unique ID of the casting call
name	string	Name of the casting call
description	string	Description of the casting call
deadline	datetime	Application deadline
visibility	string	Visibility of the casting call: `public` or `private`
deadline_visible	boolean	Whether the deadline is visible
production_format	string or null	Format of the production
casting_type	string	Type of casting: `breakdown`, `ecasting` (Self Tape Request), `studio_casting` (scheduled audition at a site)
production_id	integer	ID of the related production
working_permits	array	Required working permits
regions	array	Regions relevant to the casting call
casting_director	object	Casting director associated with the casting call
production_locations	array	Locations where the production takes place
filmmakers_url	string	Authenticated Filmmakers web URL for the casting call. The URL does not grant access by itself; use it for authenticated and authorized users, for example as an SSO `redirect_to` target.
created_at	datetime	Creation timestamp
updated_at	datetime	Last update timestamp
roles	array	List of roles available in the casting call

Casting Director Object Fields

Field	Type	Description
id	integer	Unique Filmmakers ID of the casting director entity
name	string	Name of the casting director

Production Location Object Fields

Field	Type	Description
name	string	Name of the location
country	string	ISO 3166-1 alpha-2 country code
longitude	number	Longitude of the location
latitude	number	Latitude of the location

Role Object Fields

Field	Type	Description
id	integer	Unique ID of the role
name	string	Name of the role
description	string	Description of the role
contract_type	integer or null	Contract type identifier that applies to the role. Labels are available from the `contract_types` catalogue.
contract_type_info	string or null	Additional contract information for the role; may contain HTML
deadline	datetime	Application deadline for the role
gender	array	Accepted genders for the role
acting_age_from	integer	Minimum acting age
acting_age_to	integer	Maximum acting age
languages	object	Required languages and proficiency
ethnic_background	array	Required ethnic backgrounds
ethnic_background_details	array	Additional ethnic background details
created_at	datetime	Creation timestamp
updated_at	datetime	Last update timestamp

Get All Casting Calls​

Example Response​

HTTP Request​

Query Parameters​

Current Casting Calls​

Response Fields​

Get a Specific Casting Call​

Example Response​

HTTP Request​

Response Fields​

Casting Director Object Fields​

Production Location Object Fields​

Role Object Fields​

Get All Casting Calls

Example Response

HTTP Request

Query Parameters

Current Casting Calls

Response Fields

Get a Specific Casting Call

Example Response

HTTP Request

Response Fields

Casting Director Object Fields

Production Location Object Fields

Role Object Fields