Buy a browser session with a machine payment

curl --request POST \
  --url https://api.onkernel.com/mpp/browsers \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com"
}
'

import requests

url = "https://api.onkernel.com/mpp/browsers"

payload = { "email": "jsmith@example.com" }
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jsmith@example.com'})
};

fetch('https://api.onkernel.com/mpp/browsers', 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.onkernel.com/mpp/browsers",
  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([
    'email' => 'jsmith@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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.onkernel.com/mpp/browsers"

	payload := strings.NewReader("{\n  \"email\": \"jsmith@example.com\"\n}")

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

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.onkernel.com/mpp/browsers")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jsmith@example.com\"\n}"

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

{
  "access": {
    "type": "session_urls"
  },
  "cdp_ws_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "duration_minutes": 123,
  "expires_at": "2023-11-07T05:31:56Z",
  "headless": true,
  "payment": {
    "amount": 123,
    "currency": "<string>",
    "reference": "<string>"
  },
  "session_id": "<string>",
  "stealth": true,
  "webdriver_ws_url": "<string>",
  "browser_live_view_url": "<string>"
}

{}

{
  "challengeId": "<string>",
  "code": "session_expired",
  "detail": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{}

Buy a browser session with a machine payment

Buys a stealth headful browser for the duration in the offer with a Machine Payments Protocol (MPP) payment, without a Kernel account. A request without an Authorization: Payment credential gets a 402 challenge; the paid retry returns the browser and a Payment-Receipt header. A challenge can be paid until its expires time, 30 minutes after it is issued by default. A challenge buys one browser. Resending the same paid credential is intentional and safe: it returns the same browser without charging again until the session expires, even after the challenge has expired, so an agent can retry after a timeout. After the session expires it gets a 402 with a fresh challenge and code: session_expired. A different payment for a challenge that was already charged is rejected with a 402 before any charge.

POST

mpp

browsers

curl --request POST \
  --url https://api.onkernel.com/mpp/browsers \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com"
}
'

import requests

url = "https://api.onkernel.com/mpp/browsers"

payload = { "email": "jsmith@example.com" }
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jsmith@example.com'})
};

fetch('https://api.onkernel.com/mpp/browsers', 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.onkernel.com/mpp/browsers",
  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([
    'email' => 'jsmith@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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.onkernel.com/mpp/browsers"

	payload := strings.NewReader("{\n  \"email\": \"jsmith@example.com\"\n}")

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

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.onkernel.com/mpp/browsers")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jsmith@example.com\"\n}"

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

{
  "access": {
    "type": "session_urls"
  },
  "cdp_ws_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "duration_minutes": 123,
  "expires_at": "2023-11-07T05:31:56Z",
  "headless": true,
  "payment": {
    "amount": 123,
    "currency": "<string>",
    "reference": "<string>"
  },
  "session_id": "<string>",
  "stealth": true,
  "webdriver_ws_url": "<string>",
  "browser_live_view_url": "<string>"
}

{}

{
  "challengeId": "<string>",
  "code": "session_expired",
  "detail": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{}

Body

application/json

string<email>

Optional address for the Stripe receipt. When omitted, the billing email shared with the payment token is used, if any. A malformed address is rejected with a 400 before any challenge or charge.

Response

The purchased browser session.

access

object

required

Show child attributes

cdp_ws_url

string

required

created_at

string<date-time>

required

duration_minutes

integer

required

expires_at

string<date-time>

required

headless

boolean

required

payment

object

required

Show child attributes

session_id

string

required

stealth

boolean

required

webdriver_ws_url

string

required

browser_live_view_url

string

Apps

Audit Logs

Managed Auth

Authentication

Browser Pools

Browsers

Browser Computer Controls

Browser Filesystem

Browser Logs

Browser Playwright

Browser Processes

Browser REPL

Browser Replays

Browser Telemetry

Browser WebMCP

Config Registry

Deployments

Extensions

Invocations

API Keys

Organization

Projects

Profiles

Proxies

Vaults

Buy a browser session with a machine payment

Body

Response