Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ERPNext Resource API

The Resource API from ERPNext — 2 operation(s) for resource.

ERPNext Resource API is one of 3 APIs that ERPNext publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Resource. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 2 paths, and defines 2 schemas. It is described by OpenAPI 3.0.0, at version 0.0.1.

Requests are made against 2 base URLs: https://demo.erpnext.com/api, https://{company}.erpnext.com/api.

5 operations 2 paths 2 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
0.0.1
Base URL
https://{your-erpnext-instance}/api
Authentication
API Key, HTTP Basic, OAuth 2.0
License
GPL-3.0
Resource Areas
1

Authentication & Security 3

ERPNext Resource API declares 3 security schemes for authenticating requests. An API key is passed in the header as Authorization (tokenAuth). It accepts HTTP basic authentication (basicAuth). It supports OAuth 2.0 (oAuth2) using the authorizationCode flow, exposing 1 scope.

  • tokenAuth — Get your API keys at User - Api Access - Generate Keys. "headers = {'Authorization': 'token : '}"
  • basicAuth — Get your API keys at User - Api Access - Generate Keys. username = apikey; password = apisecret [More info](https://frappe.io/docs/user/en/guides/integration/t…
  • oAuth2 — This API uses OAuth 2 with the authorization code flow. [More info]https://frappe.io/docs/user/en/guides/integration/usingoauth)

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Resource 5
POST
/resource/{DocType}
Create a new document
1 param body → 200403
GET
/resource/{DocType}
Get a list of documents
5 params → 200
GET
/resource/{DocType}/{DocumentName}
Get a specific document
2 params → 200
PUT
/resource/{DocType}/{DocumentName}
Update a specific document
2 params → 200
DELETE
/resource/{DocType}/{DocumentName}
Delete a specific document
2 params → 202

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are DocType (7 properties), DocList (1 property). Each schema is shown below with its type and property counts.

DocList
object
1 property
DocType
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

erpnext-resource-api-openapi.yml Raw ↑

Other APIs ERPNext publishes across the network.

ERPNext Method API
ERPNext Naive Authentication API