Xero Files API

xero · Finance

Finance No Auth Free & Open financial

These endpoints are specific to Xero Files API

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Retrieves files

Retrieves files

https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Files?page=2&sort=CreatedDateUTC DESC&pagesize=50

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

xero-tenant-id

example

curl -X GET "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Files?page=2&sort=CreatedDateUTC%20DESC&pagesize=50" \
  -H "xero-tenant-id: example"

import requests
params = {
    "page": "2",
    "sort": "CreatedDateUTC DESC",
    "pagesize": "50"
}
headers = {
    "xero-tenant-id": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Files",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Files');
url.searchParams.set('page', '2');
url.searchParams.set('sort', 'CreatedDateUTC DESC');
url.searchParams.set('pagesize', '50');

const response = await fetch(url, {
  headers: {
    'xero-tenant-id': 'example'
  },
}); 
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/xero.com/xero_files/2.9.4/Files")
	q := baseURL.Query()
	q.Set("page", "2")
	q.Set("sort", "CreatedDateUTC DESC")
	q.Set("pagesize", "50")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("xero-tenant-id", "example")

	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/xero.com/xero_files/2.9.4/Files")
uri.query = URI.encode_www_form({
  "page" => "2",
  "sort" => "CreatedDateUTC DESC",
  "pagesize" => "50"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["xero-tenant-id"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Files?" . http_build_query([
    "page" => "2",
    "sort" => "CreatedDateUTC DESC",
    "pagesize" => "50"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "xero-tenant-id: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Retrieves folders

By passing in the appropriate options, you can search for available folders

https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Folders?sort=CreatedDateUTC DESC

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

xero-tenant-id

example

curl -X GET "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Folders?sort=CreatedDateUTC%20DESC" \
  -H "xero-tenant-id: example"

import requests
params = {
    "sort": "CreatedDateUTC DESC"
}
headers = {
    "xero-tenant-id": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Folders",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Folders');
url.searchParams.set('sort', 'CreatedDateUTC DESC');

const response = await fetch(url, {
  headers: {
    'xero-tenant-id': 'example'
  },
}); 
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/xero.com/xero_files/2.9.4/Folders")
	q := baseURL.Query()
	q.Set("sort", "CreatedDateUTC DESC")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("xero-tenant-id", "example")

	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/xero.com/xero_files/2.9.4/Folders")
uri.query = URI.encode_www_form({
  "sort" => "CreatedDateUTC DESC"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["xero-tenant-id"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Folders?" . http_build_query([
    "sort" => "CreatedDateUTC DESC"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "xero-tenant-id: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Retrieves inbox folder

Search for the user inbox

https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Inbox

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

xero-tenant-id

example

curl -X GET "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Inbox" \
  -H "xero-tenant-id: example"

import requests
headers = {
    "xero-tenant-id": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Inbox",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Inbox';

const response = await fetch(url, {
  headers: {
    'xero-tenant-id': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

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

func main() {
	targetURL := "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Inbox"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("xero-tenant-id", "example")

	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/xero.com/xero_files/2.9.4/Inbox")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["xero-tenant-id"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/xero.com/xero_files/2.9.4/Inbox";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "xero-tenant-id: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Xero Files API?

Xero Files API is a Finance API. Developers commonly use finance APIs for:

processing payments and handling transactions
building subscription and billing systems
automating invoicing and financial reporting
fraud detection and risk scoring
connecting to banking and accounting software

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Xero Files API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗