Supported Versions | 12.0 | 13.0 | 14.0 | 15.0 | 16.0 | 17.0 | 18.0 |
---|---|---|---|---|---|---|---|
Community | |||||||
Enterprise |
https://www.ekika.co/support
- Our All API Addons: EKIKA API Addons
- All-in-One is “api_framework” (Buy): Easy API Framework
Odoo Standard RESTful JSON API

This module allows you Odoo’s Standard RESTful JSON formats with api_framework features. It adds multiple authentication methods, access control, logs and CORS which enhances communication between Odoo and external systems. Ideal for developers and businesses, it offers an easy way to integrate Odoo with other applications.
How It Works:
By defining a standard structure for API requests and responses, this module promotes consistency and ease of use.
Each request includes a various methods such as Search, Search Read, Read, Check Access Right, & Create etc, that defines the action to be performed on the resource. The server’s response typically contains the requested data in JSON format, along with an HTTP status code to indicate success or failure.
Standard REST Json API Request’s Overview:
- This is the main query parameters which is mandatory to write when you are working with APIs.
- Use “HTTP POST Method” to send specific data.
- Domain is specified your wesite’s domain address. The port number is optional.
- Endpoint is the specific path within the API that identifies the particular resource or action.
This part of the URL tells the server what type of operation is being requested. - Model is Odoo’s technical name of entities and also known as model name, record’s model or
entities. You can identify it from the URL shown below. - Method specifies the type of action being performed on the server.
- Headers in an API request are key-value pairs sent between the client and the server, providing
additional information about the request or the client itself. They are part of the HTTP protocol and can
carry various types of metadata. - Add “Content-Type” and “x-api-key” keys with their specific values. REST API’s media
type designation is “application/json“. Add this in Content-Type’s value field and also add your
API Key.

Search:
See the Example with Query & Output:
Example: This query searches for res.partner records in a local Odoo instance via the /api-rest-json/res.partner/search endpoint.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/search" payload = json.dumps({ "args": [ [ [ "is_company", "=", True ] ] ], "kwargs": {} }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Search Read:
See the Example with Query & Output:
Example: This query combines search and read operations for res.partner records in a local Odoo instance via the /api-rest-json/res.partner/search_read endpoint. It retrieves records that match specified criteria and returns their details in a single request.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/search_read" payload = json.dumps({ "args": [ [ [ "is_company", "=", True ] ] ], "kwargs": { "fields": [ "name", "country_id", "comment", "is_company" ], "limit": 5 } }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Search Count:
See the Example with Query & Output:
Example: This query returns the count of res.partner records in a local Odoo instance via the /api-rest-json/res.partner/search_count endpoint.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/search_count" payload = json.dumps({ "args": [ [ [ "is_company", "=", True ] ] ], "kwargs": {} }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Read:
See the Example with Query & Output:
Example: This query retrieves details of res.partner records from a local Odoo instance via the /api-rest-json/res.partner/read endpoint.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/read" payload = json.dumps({ "args": [ [ 14, 10, 11 ] ], "kwargs": { "fields": [ "name", "country_id", "comment", "is_company" ] } }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Read Group:
See the Example with Query & Output:
Example:
This query retrieves grouped data for res.partner records in a local Odoo instance via the /api-rest-json/res.partner/read_group endpoint. It allows grouping records based on specified fields.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/read_group" payload = json.dumps({ "args": [ [ [ "is_company", "=", False ] ] ], "kwargs": { "fields": [ "name", "country_id", "comment", "is_company" ], "groupby": "country_id" } }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Create:
See the Example with Query & Output:
Example: This query creates a new res.partner record in a local Odoo instance via the /api-rest-json/res.partner/create endpoint. It uses the POST method to send the necessary data for the new record.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/create" payload = json.dumps({ "args": [ { "name": "Sample Partner", "email": "sample-partner@example.com" } ], "kwargs": {} }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Write:
See the Example with Query & Output:
Example: This query updates existing res.partner records in a local Odoo instance via the /api-rest-json/res.partner/write endpoint. It uses the POST method to send updated data for specific records, modifying their fields.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/write" payload = json.dumps({ "args": [ [ 49 ], { "name": "Sample Partner Change", "email": "sample-partner-change@example.com" } ], "kwargs": {} }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Unlink:
See the Example with Query & Output:
Example: This query deletes res.partner records in a local Odoo instance via the /api-rest-json/res.partner/unlink endpoint. It uses the POST method to remove specified records from the system.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/unlink" payload = json.dumps({ "args": [ [ 49 ] ], "kwargs": {} }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Fields Get:
See the Example with Query & Output:
Example: This query retrieves the field definitions for the res.partner model in a local Odoo instance via the /api-rest-json/res.partner/fields_get endpoint. It provides information about the fields, such as their types, labels, and other properties.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/fields_get" payload = json.dumps({ "args": [], "kwargs": { "attributes": [ "string", "help", "type" ] } }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Check Access Rights:
See the Example with Query & Output:
Example: This query checks the access rights for the res.partner model in a local Odoo instance via the /api-rest-json/res.partner/check_access_rights endpoint. It verifies whether the user has the necessary permissions (such as create, read, write, delete) for the specified model.

*** python *** import requests import json url = "http://localhost:8016/api-rest-json/res.partner/check_access_rights" payload = json.dumps({ "args": [ "create" ], "kwargs": {} }) headers = { 'Content-Type': 'application/json', 'x-api-key': 'YOUR-API-KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
Swagger Documentation
Services EKIKA Provides
EKIKA is your destination for expert Odoo ERP implementation and customization. We pride ourselves on building reliable, trust-based partnerships that give you full transparency and control over your business processes.
With over 12 years of experience, we can assist you with eCommerce platforms, production planning, point-of-sale systems, managing inventory adjustments, and providing advanced field worker tracking solutions to optimize your workflows and boost operational efficiency.

Implementation
Utilise Odoo ERP tailored for your business needs for smooth operations.

Customization
Personalized adjustments to Odoo modules for seamless management.

Support
Ongoing assistance and maintenance to optimize your Odoo system’s performance.
Are you struggling with disorganized operations, high operational costs, or lack of transparency in your processes? What sets us apart is our commitment to personalized solutions tailored to your unique business needs and our proactive support, ensuring seamless integration and ongoing success.
Would you like to explore Odoo ERP for your business? Schedule a free consultation with EKIKA today!
You must log in to submit a review.