Particle Ledger API

The Ledger API from Particle — 6 operation(s) for ledger.

Operations 11

GET /v1/ledgers/{ledgerName}/instances/{scopeValue}/versions List ledger instance versions #
GET /v1/ledgers List ledger definitions #
POST /v1/ledgers Create a new ledger definition #
GET /v1/ledgers/{ledgerName} Get ledger definition #
PUT /v1/ledgers/{ledgerName} Update ledger definition #
DELETE /v1/ledgers/{ledgerName} Archive a ledger definition #
GET /v1/ledgers/{ledgerName}/instances List ledger instances #
GET /v1/ledgers/{ledgerName}/instances/{scopeValue} Get ledger instance #
PUT /v1/ledgers/{ledgerName}/instances/{scopeValue} Set the ledger instance data #
DELETE /v1/ledgers/{ledgerName}/instances/{scopeValue} Delete ledger instance #
GET /v1/ledgers/{ledgerName}/instances/{scopeValue}/versions/{version} Get ledger instance version #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/particle-ledger-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

particle-ledger-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Particle Cloud Ledger API
  description: The Particle Cloud REST API enables developers to interact with Particle-connected devices — calling device functions, reading variables, publishing and subscribing to events, managing SIM cards, performing OTA firmware updates, and administering product fleets. All requests use OAuth 2.0 bearer tokens and target https://api.particle.io.
  version: 1.0.0
  contact:
    name: Particle Developer Support
    url: https://docs.particle.io/reference/cloud-apis/api/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://api.particle.io
  description: Particle Cloud API
security:
- bearerAuth: []
tags:
- name: Ledger
paths:
  /v1/ledgers/{ledgerName}/instances/{scopeValue}/versions:
    get:
      summary: List ledger instance versions
      operationId: GetV1LedgersLedgernameInstancesScopevalueVersions
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Lists all ledger instance versions.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
      - name: scopeValue
        in: path
        required: true
        schema:
          type: string
  /v1/ledgers:
    get:
      summary: List ledger definitions
      operationId: GetV1Ledgers
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Lists all ledger definitions belonging to the Sandbox or organization.
    post:
      summary: Create a new ledger definition
      operationId: PostV1Ledgers
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Creates a ledger definition.
  /v1/ledgers/{ledgerName}:
    get:
      summary: Get ledger definition
      operationId: GetV1LedgersLedgername
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Returns the specified ledger definition.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
    put:
      summary: Update ledger definition
      operationId: PutV1LedgersLedgername
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Updates the ledger definition.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
    delete:
      summary: Archive a ledger definition
      operationId: DeleteV1LedgersLedgername
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Archives a ledger definition.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
  /v1/ledgers/{ledgerName}/instances:
    get:
      summary: List ledger instances
      operationId: GetV1LedgersLedgernameInstances
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Lists all ledger instances.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
  /v1/ledgers/{ledgerName}/instances/{scopeValue}:
    get:
      summary: Get ledger instance
      operationId: GetV1LedgersLedgernameInstancesScopevalue
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Returns the specified ledger instance.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
      - name: scopeValue
        in: path
        required: true
        schema:
          type: string
    put:
      summary: Set the ledger instance data
      operationId: PutV1LedgersLedgernameInstancesScopevalue
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Sets the data of the specified ledger instance.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
      - name: scopeValue
        in: path
        required: true
        schema:
          type: string
    delete:
      summary: Delete ledger instance
      operationId: DeleteV1LedgersLedgernameInstancesScopevalue
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Deletes the specified ledger instance.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
      - name: scopeValue
        in: path
        required: true
        schema:
          type: string
  /v1/ledgers/{ledgerName}/instances/{scopeValue}/versions/{version}:
    get:
      summary: Get ledger instance version
      operationId: GetV1LedgersLedgernameInstancesScopevalueVersionsVersion
      tags:
      - Ledger
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request
        '401':
          description: Unauthorized
      description: Returns the specified version of a ledger instance.
      parameters:
      - name: ledgerName
        in: path
        required: true
        schema:
          type: string
      - name: scopeValue
        in: path
        required: true
        schema:
          type: string
      - name: version
        in: path
        required: true
        schema:
          type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 bearer token. Obtain via POST /oauth/token.
externalDocs:
  description: Particle Cloud API Reference
  url: https://docs.particle.io/reference/cloud-apis/api/