/v2/ratecard

GET

Parameter Options
token A valid access token.
organization An organization string.
project A project string.
type A project type string.
duration A project duration string.
region A project region string.

Usage

When only the token is supplied, the API responds with the full rate card structure for your portal (see below).

The other optional parameters are used to specify the set of conditions for calculating a specific rate.

Example rate card structure:

  {
    "organizations": [
      {
        "name": "Individual",
        "projects": [
          {
            "name": "Online Video",
            "license_type": "1",
            "types": [
              "Personal",
              "Personal Premium",
              "Non-Profit, Educational"
            ],
            "durations": [
              "1 Year",
              "Perpetuity"
            ],
            "regions": [
              "Worldwide",
              "The Universe"
            ]
          },
          {
            "name": "Film",
            "license_type": "2",
            "types": [
              "Fundraiser",
              "Film Festival",
              "DVD (< 100 Units)",
              "Film Festival + DVD (< 100 Units)",
              "Worldwide All Media Release"
            ],
            "durations": [
              "1 Year",
              "Perpetuity"
            ],
            "regions": [
              "United States",
              "Worldwide",
              "The Universe"
            ]
          }
        ]
      } 
    ],
    "descriptions" : {
      "Individual":"An Individual",
      "Non-profit/Educational":"A Non-profit or Educational Organization",
      "Music Supervisor":"An Individual Providing Music Supervision Services",
      "Commercial Production":"A Media Production Company with More than Ten Employees",
      "Small Business":"A Non-media Business with Under 30 Employees",
      "All Media Commercial":"A Advertisement for All Media Types",
      "Fundraiser":"At A Fundraising Event",
      "Film Festival":"At A Film Festival",
      . . .
    }
  }
  

Given the above rate card, an example query to generate the rate for a license to an Individual for a Fundraiser Film, good for 1 Year in the United States:

  GET /v2/ratecard \
    ?token=... \
    &organization=Individual \
    &project=Film \
    &type=Fundraiser \
    &duration=1+Year \
    &region=United+States
  

This will return { 'rate' : 250.0 } where rate is measured in US dollars.

Try It!