Ir para o conteúdo
NovoDID documentação
API públicaReferência por operaçãoComprar números

Listar pedidos da conta

Lista os pedidos da conta por data, do mais recente ao mais antigo. Aceita apenas paginação.

Catálogo, cotação, pagamento e acompanhamento de um DID por pedido.

Base: https://novodid.com. Consulte autenticação e limites antes de executar operações.

Listar pedidos da conta

GET /api/v1/orders

Lista os pedidos da conta por data, do mais recente ao mais antigo. Aceita apenas paginação.

Permissão: orders:read

  • limit: 1–100, padrão 20; page: 1–9999, padrão 1. Uma página vazia indica o fim da lista.

Filtros e parâmetros

?limit=20&page=1

Resposta de sucesso (200)

{
  "orders": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "didId": 1234,
      "quantity": 1,
      "status": "awaiting_payment",
      "paymentMethod": "pix",
      "currency": "BRL",
      "amount": 1499,
      "createdAt": "2026-09-23T15:00:00.000Z",
      "expiresAt": "2026-09-23T15:15:00.000Z",
      "checkoutUrl": null,
      "pix": {
        "copyPaste": "PIX_COPY_AND_PASTE_EXAMPLE",
        "qrCodeDataUrl": "data:image/png;base64,EXAMPLE"
      }
    }
  ],
  "page": 1,
  "limit": 20
}

Exemplo de erro

{
  "error": {
    "code": "insufficient_scope",
    "message": "Token sem permissão para esta operação."
  }
}

curl

curl -X GET \
  -H "Authorization: Bearer $NOVODID_API_TOKEN" \
  "https://novodid.com/api/v1/orders?limit=20&page=1"

Node

const response = await fetch("https://novodid.com/api/v1/orders?limit=20&page=1", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.NOVODID_API_TOKEN}`
  }
});
const payload = await response.json();

if (!response.ok) {
  throw new Error(payload.error?.message || "Erro na API NovoDID");
}

console.log({ status: response.status });

Python

import os
import requests

response = requests.get(
    "https://novodid.com/api/v1/orders?limit=20&page=1",
    headers={"Authorization": f"Bearer {os.environ['NOVODID_API_TOKEN']}"},
    timeout=30,
)

payload = response.json()
response.raise_for_status()
print({"status": response.status_code})

Go

package main

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

func main() {
    req, err := http.NewRequest("GET", "https://novodid.com/api/v1/orders?limit=20&page=1", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer "+os.Getenv("NOVODID_API_TOKEN"))

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()

    _, _ = io.Copy(io.Discard, res.Body)
    if res.StatusCode >= 300 {
        panic(fmt.Sprintf("NovoDID API HTTP %d", res.StatusCode))
    }

    fmt.Println(res.StatusCode)
}

Rust

use reqwest::blocking::Client;
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let response = client
        .get("https://novodid.com/api/v1/orders?limit=20&page=1")
        .bearer_auth(env::var("NOVODID_API_TOKEN")?)
        .send()?;

    let status = response.status();
    let _payload = response.text()?;
    if !status.is_success() {
        return Err(format!("NovoDID API HTTP {}", status).into());
    }

    println!("HTTP {}", status);
    Ok(())
}

PHP

<?php

$ch = curl_init("https://novodid.com/api/v1/orders?limit=20&page=1");

curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("NOVODID_API_TOKEN")
  ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($response === false || $status >= 300) {
  throw new RuntimeException("NovoDID API HTTP " . $status);
}

echo $status . PHP_EOL;

Ruby

require "net/http"

uri = URI("https://novodid.com/api/v1/orders?limit=20&page=1")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("NOVODID_API_TOKEN")}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

raise "NovoDID API HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)

puts response.code

C#

using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://novodid.com/api/v1/orders?limit=20&page=1");

request.Headers.Authorization = new AuthenticationHeaderValue(
    "Bearer",
    Environment.GetEnvironmentVariable("NOVODID_API_TOKEN")
);

using var response = await client.SendAsync(request);
var payload = await response.Content.ReadAsStringAsync();

response.EnsureSuccessStatusCode();
Console.WriteLine(response.StatusCode);

Nesta página