Querying and the query builder

COEVERA_BASE="https://{region}.api.coevera.com/api/v100/rest/spaces/{space_id}"

# -d sends each value as written, so the comma in filter[city] stays raw: Seattle OR Portland.
curl -sS --fail-with-body -G "$COEVERA_BASE/entities/Accounts" \
  -d "filter[city]=Seattle,Portland" \
  -d "filter[modified]=2026-01-01" \
  -d "filter-op[modified]=gte" \
  -d order-by=-modified \
  -d load-only=id,name,city,modified \
  -d first=10 \
  -u "$COEVERA_API_KEY:$COEVERA_API_SECRET"

import { Buffer } from "node:buffer";
import { env } from "node:process";

const base = `https://{region}.api.coevera.com/api/v100/rest/spaces/{space_id}`;
const auth = Buffer.from(`${env.COEVERA_API_KEY}:${env.COEVERA_API_SECRET}`).toString("base64");

// Each OR value is encoded on its own and the values are joined with a raw comma. Do not build
// this with URLSearchParams: it sends the comma as %2C, which is a literal comma.
const cities = ["Seattle", "Portland"].map(encodeURIComponent).join(",");
const query = [
  `filter[city]=${cities}`,
  "filter[modified]=2026-01-01",
  "filter-op[modified]=gte",
  "order-by=-modified",
  "load-only=id,name,city,modified",
  "first=10",
].join("&");
const res = await fetch(`${base}/entities/Accounts?${query}`, { headers: { Authorization: `Basic ${auth}` } });
const body = await res.json();
if (!res.ok) throw new Error(`HTTP ${res.status} ${body.name}: ${body.message}`);
console.log(`${body.total} matching accounts:`, JSON.stringify(body.data, null, 2));

import json
import os
import sys
from urllib.parse import quote

import requests

BASE = "https://{region}.api.coevera.com/api/v100/rest/spaces/{space_id}"
session = requests.Session()
session.auth = (os.environ["COEVERA_API_KEY"], os.environ["COEVERA_API_SECRET"])

# Each OR value is encoded on its own and the values are joined with a raw comma. Do not pass
# the filter in params=: requests sends the comma as %2C, which is a literal comma.
cities = ",".join(quote(city, safe="") for city in ["Seattle", "Portland"])
query = "&".join([
    f"filter[city]={cities}",
    "filter[modified]=2026-01-01",
    "filter-op[modified]=gte",
    "order-by=-modified",
    "load-only=id,name,city,modified",
    "first=10",
])
response = session.get(f"{BASE}/entities/Accounts?{query}", timeout=30)
body = response.json()
if not response.ok:
    sys.exit(f"HTTP {response.status_code} {body.get('name')}: {body.get('message')}")
print(body.get("total"), "matching accounts:", json.dumps(body["data"], indent=2))

COEVERA_GRAPHQL="https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public"

curl -sS --fail-with-body "$COEVERA_GRAPHQL" \
  -u "$COEVERA_API_KEY:$COEVERA_API_SECRET" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "query": "{ entities { account { getByCriteria(first: 10, filter: { AND: [{ city: { eq: [\"Seattle\", \"Portland\"] } }, { modified: { gte: \"2026-01-01T00:00:00\" } }] }, orderBy: [{ modified: Desc }]) { totalCount edges { node { id name city modified } } } } } }"
}
JSON

import { Buffer } from "node:buffer";
import { env } from "node:process";

const endpoint = `https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public`;
const auth = Buffer.from(`${env.COEVERA_API_KEY}:${env.COEVERA_API_SECRET}`).toString("base64");

const ACCOUNTS = `{
  entities {
    account {
      getByCriteria(
        first: 10
        filter: {
          AND: [
            { city: { eq: ["Seattle", "Portland"] } }
            { modified: { gte: "2026-01-01T00:00:00" } }
          ]
        }
        orderBy: [{ modified: Desc }]
      ) {
        totalCount
        edges { node { id name city modified } }
      }
    }
  }
}`;
const res = await fetch(endpoint, {
  method: "POST",
  headers: { Authorization: `Basic ${auth}`, "Content-Type": "application/json" },
  body: JSON.stringify({ query: ACCOUNTS }),
});
const body = await res.json();
// GraphQL reports errors in the body, often with HTTP 200: check both.
if (!res.ok || body.errors) throw new Error(`HTTP ${res.status}: ${JSON.stringify(body.errors ?? body)}`);
const accounts = body.data.entities.account.getByCriteria;
console.log(`${accounts.totalCount} matching accounts:`, JSON.stringify(accounts.edges, null, 2));

import json
import os
import sys

import requests

ENDPOINT = (
    "https://{region}.api.coevera.com/api/v100/app/space/"
    "{space_id}/graphql/public"
)
AUTH = (os.environ["COEVERA_API_KEY"], os.environ["COEVERA_API_SECRET"])

ACCOUNTS = """
{
  entities {
    account {
      getByCriteria(
        first: 10
        filter: {
          AND: [
            { city: { eq: ["Seattle", "Portland"] } }
            { modified: { gte: "2026-01-01T00:00:00" } }
          ]
        }
        orderBy: [{ modified: Desc }]
      ) {
        totalCount
        edges { node { id name city modified } }
      }
    }
  }
}
"""
response = requests.post(ENDPOINT, json={"query": ACCOUNTS}, auth=AUTH, timeout=30)
body = response.json()
# GraphQL reports errors in the body, often with HTTP 200: check both.
if not response.ok or body.get("errors"):
    sys.exit(f"HTTP {response.status_code}: {json.dumps(body.get('errors', body))}")
accounts = body["data"]["entities"]["account"]["getByCriteria"]
print(accounts["totalCount"], "matching accounts:", json.dumps(accounts["edges"], indent=2))