Pims
pims · Commerce
Hereafter is the documentation of the private API of [Pims: Pointages Intelligents pour le Monde du Spectacle](https://pims.io). This API is designed for 3rd-party softwares, editors and partners. Its main purpose is to give access the core data of a Pims customer (i.e. events, ticket counts and promotions). ## Authentication The API uses [basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication), meaning you will need a username and password to get authorized. A
Authentication
Sample Requests
Find all categories
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/pims.io/1.0/categories?sort=order&label=example&page_size=25&show_ignored=false"
import requests
params = {
"sort": "order",
"label": "example",
"page_size": "25",
"show_ignored": "false"
}
response = requests.get(
"https://api.apis.guru/v2/specs/pims.io/1.0/categories",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/pims.io/1.0/categories');
url.searchParams.set('sort', 'order');
url.searchParams.set('label', 'example');
url.searchParams.set('page_size', '25');
url.searchParams.set('show_ignored', 'false');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/pims.io/1.0/categories")
q := baseURL.Query()
q.Set("sort", "order")
q.Set("label", "example")
q.Set("page_size", "25")
q.Set("show_ignored", "false")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/pims.io/1.0/categories")
uri.query = URI.encode_www_form({
"sort" => "order",
"label" => "example",
"page_size" => "25",
"show_ignored" => "false"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/pims.io/1.0/categories?" . http_build_query([
"sort" => "order",
"label" => "example",
"page_size" => "25",
"show_ignored" => "false"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Find all channels
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/pims.io/1.0/channels?sort=label&label=example&page_size=25&show_ignored=false"
import requests
params = {
"sort": "label",
"label": "example",
"page_size": "25",
"show_ignored": "false"
}
response = requests.get(
"https://api.apis.guru/v2/specs/pims.io/1.0/channels",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/pims.io/1.0/channels');
url.searchParams.set('sort', 'label');
url.searchParams.set('label', 'example');
url.searchParams.set('page_size', '25');
url.searchParams.set('show_ignored', 'false');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/pims.io/1.0/channels")
q := baseURL.Query()
q.Set("sort", "label")
q.Set("label", "example")
q.Set("page_size", "25")
q.Set("show_ignored", "false")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/pims.io/1.0/channels")
uri.query = URI.encode_www_form({
"sort" => "label",
"label" => "example",
"page_size" => "25",
"show_ignored" => "false"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/pims.io/1.0/channels?" . http_build_query([
"sort" => "label",
"label" => "example",
"page_size" => "25",
"show_ignored" => "false"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Find all price ranges
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/pims.io/1.0/price-ranges?sort=label&label=example&page_size=25&show_ignored=false"
import requests
params = {
"sort": "label",
"label": "example",
"page_size": "25",
"show_ignored": "false"
}
response = requests.get(
"https://api.apis.guru/v2/specs/pims.io/1.0/price-ranges",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/pims.io/1.0/price-ranges');
url.searchParams.set('sort', 'label');
url.searchParams.set('label', 'example');
url.searchParams.set('page_size', '25');
url.searchParams.set('show_ignored', 'false');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/pims.io/1.0/price-ranges")
q := baseURL.Query()
q.Set("sort", "label")
q.Set("label", "example")
q.Set("page_size", "25")
q.Set("show_ignored", "false")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/pims.io/1.0/price-ranges")
uri.query = URI.encode_www_form({
"sort" => "label",
"label" => "example",
"page_size" => "25",
"show_ignored" => "false"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/pims.io/1.0/price-ranges?" . http_build_query([
"sort" => "label",
"label" => "example",
"page_size" => "25",
"show_ignored" => "false"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Pims?
Pims is a Commerce API. Developers commonly use commerce APIs for:
- syncing product catalogues and inventory levels
- building price comparison and deal-finder tools
- processing orders and tracking shipments
- managing customer wishlists and reviews
- automating abandoned-cart and promotional emails
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Pims is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?