Skip to main content
GET
/
integrations
/
{id}
/
logs
Retrieve exception logs for a specific integration
curl --request GET \
  --url https://panel.sendcloud.sc/api/v2/integrations/{id}/logs \
  --header 'Authorization: Basic <encoded-value>'
import requests

url = "https://panel.sendcloud.sc/api/v2/integrations/{id}/logs"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://panel.sendcloud.sc/api/v2/integrations/{id}/logs', 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://panel.sendcloud.sc/api/v2/integrations/{id}/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

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

curl_close($curl);

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

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

func main() {

	url := "https://panel.sendcloud.sc/api/v2/integrations/{id}/logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

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

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

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://panel.sendcloud.sc/api/v2/integrations/{id}/logs")
  .header("Authorization", "Basic <encoded-value>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://panel.sendcloud.sc/api/v2/integrations/{id}/logs")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body
{
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "id": 123,
      "base_url": "https://example.com",
      "full_url": "https://example.com/order-note.json",
      "method": "POST",
      "response_code": 495,
      "response": {
        "headers": {
          "Cache-Control": "max-age=3600",
          "Content-Type": "text/html; charset=utf-8",
          "Connection": "keep-alive"
        },
        "body": "<!doctype html>\n<html>\n <head>\n <title>SSL Certificate Error</title>\n </head>\n </html>\n"
      },
      "request": {
        "headers": {
          "Cache-Control": "max-age=3600",
          "Content-Type": "text/html; charset=utf-8",
          "Connection": "keep-alive"
        },
        "payload": {
          "order_note": {
            "note": "Success"
          }
        }
      },
      "created_at": "2023-03-01T02:02:00+01:00",
      "exception_type": "requests.exceptions.SSLError",
      "exception": "An SSL error occurred",
      "protected": false
    },
    {
      "id": 124,
      "integration_id": 123,
      "user_id": 123,
      "base_url": "https://example.com",
      "full_url": "https://example.com/order-note.json",
      "method": "POST",
      "response_code": 404,
      "response": {},
      "request": {
        "headers": {
          "Cache-Control": "max-age=3600",
          "Content-Type": "text/html; charset=utf-8",
          "Connection": "keep-alive"
        },
        "payload": {}
      },
      "created_at": "2023-03-01T02:02:00+01:00",
      "exception": "PageNotFound",
      "protected": false
    }
  ]
}
{
  "error": {
    "code": 404,
    "request": "api/v2/integrations/",
    "message": "No Integration matches the given query."
  }
}
API v2 is entering maintenance mode. New users should start with API v3 to access our latest features and improved performance. Already using v2? Don’t worry, your current integration remains fully functional. Read more about maintenance mode, or check out the migration guide for API v3.
Integration exception logs might be generated, for example:
  • if some resource cannot be found
  • if API credentials are no longer valid
Each log record may contain information about the request and response, the status code and code exception, and can be used as a reference to identify issues between Sendcloud and a webshop.

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Path Parameters

​
id
integer
required

The id of the integration to which the shipments belong

Response

OK

​
next
string<uri>

Cursor based pagination url to go forward. By following this URL you can get a next batch of logs

​
previous
string<uri>

Cursor based pagination url to go backwards. By following this URL you can get a previous batch of logs

​
results
Integration Log Object · object[]