Estimate submission price

curl --request POST \
  --url https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "files": [
    {
      "blobPath": "550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4"
    },
    {
      "blobPath": "660e8400-e29b-41d4-a716-446655440111/brief.pdf"
    }
  ]
}
'

import requests

url = "https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate"

payload = { "files": [{ "blobPath": "550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4" }, { "blobPath": "660e8400-e29b-41d4-a716-446655440111/brief.pdf" }] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    files: [
      {blobPath: '550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4'},
      {blobPath: '660e8400-e29b-41d4-a716-446655440111/brief.pdf'}
    ]
  })
};

fetch('https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'files' => [
        [
                'blobPath' => '550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4'
        ],
        [
                'blobPath' => '660e8400-e29b-41d4-a716-446655440111/brief.pdf'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate"

	payload := strings.NewReader("{\n  \"files\": [\n    {\n      \"blobPath\": \"550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4\"\n    },\n    {\n      \"blobPath\": \"660e8400-e29b-41d4-a716-446655440111/brief.pdf\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"files\": [\n    {\n      \"blobPath\": \"550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4\"\n    },\n    {\n      \"blobPath\": \"660e8400-e29b-41d4-a716-446655440111/brief.pdf\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"files\": [\n    {\n      \"blobPath\": \"550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4\"\n    },\n    {\n      \"blobPath\": \"660e8400-e29b-41d4-a716-446655440111/brief.pdf\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "files": [],
  "totalCredits": 0
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

API Endpoints

Estimate submission price

Preview how many credits a submission will cost, before you create it.

Call this after uploading your assets (via POST /uploads/url) and before POST /submissions. Pass the same blobPaths you intend to submit; the response returns the credit cost per asset plus a totalCredits for the whole batch.

The asset type and MIME type are derived from the blobPath server-side — the same way the create endpoint does — and the cost is computed from a metric measured on the uploaded bytes themselves (video duration, document page count), never declared by the client. So the estimate matches the amount actually charged when you create the submission. The measurement is cached, so the subsequent submission does not re-read the file.

This endpoint is read-only: it does not create a submission, move any blob, or consume credits. An asset whose metric can’t be measured (e.g. an unreadable PDF) comes back with priceable: false and credits: 0, and is excluded from totalCredits; re-upload it as a readable file before submitting.

POST

api

pricing

estimate

Estimate submission price

curl --request POST \
  --url https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "files": [
    {
      "blobPath": "550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4"
    },
    {
      "blobPath": "660e8400-e29b-41d4-a716-446655440111/brief.pdf"
    }
  ]
}
'

import requests

url = "https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate"

payload = { "files": [{ "blobPath": "550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4" }, { "blobPath": "660e8400-e29b-41d4-a716-446655440111/brief.pdf" }] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    files: [
      {blobPath: '550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4'},
      {blobPath: '660e8400-e29b-41d4-a716-446655440111/brief.pdf'}
    ]
  })
};

fetch('https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'files' => [
        [
                'blobPath' => '550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4'
        ],
        [
                'blobPath' => '660e8400-e29b-41d4-a716-446655440111/brief.pdf'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate"

	payload := strings.NewReader("{\n  \"files\": [\n    {\n      \"blobPath\": \"550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4\"\n    },\n    {\n      \"blobPath\": \"660e8400-e29b-41d4-a716-446655440111/brief.pdf\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"files\": [\n    {\n      \"blobPath\": \"550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4\"\n    },\n    {\n      \"blobPath\": \"660e8400-e29b-41d4-a716-446655440111/brief.pdf\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.northell.io/nhl/prod/mediamagic-verify-integrations/api/pricing/estimate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"files\": [\n    {\n      \"blobPath\": \"550e8400-e29b-41d4-a716-446655440000/campaign-video.mp4\"\n    },\n    {\n      \"blobPath\": \"660e8400-e29b-41d4-a716-446655440111/brief.pdf\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "files": [],
  "totalCredits": 0
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

X-API-Key

string

header

default:sk_live_your_api_key_here

required

Workspace-scoped API key. Format: sk_live_{64 hex chars}

Body

application/json

files

PricingEstimateFileInput · object[]

The uploaded assets you intend to submit. The same blobPaths you would pass to POST /submissions.

Show child attributes

Response

Successful Response

files

PricedFileSchema · object[]

Per-file pricing, in the order supplied.

Show child attributes

totalCredits

integer

default:0

Sum of credits across all priceable files — what creating the submission will cost.

Getting Started

Core Concepts

Guides

Reference

API Endpoints

Estimate submission price

Authorizations

Body

Response