# Read Filter Records Record data is accessible via the `search_read()` (shortcut which as its name suggests is equivalent to a [search()](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html?highlight=search_count#odoo.models.Model.search_count) followed by a [read()](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.models.Model.read), but avoids having to perform two requests and keep ids around). It takes similar arguments of [search()](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.models.Model.search) and optionally a list of fields to fetch. By default, it will fetch all the records and relevant fields the current user can read, which tends to be a huge amount. **`GET /restapi/1.0/object/{object_name}/?domain={comma_separated_list_of_args}`** **Request:** ``` GET /restapi/1.0/object/res.partner?domain=[('is_company','=',True),('customer','=',True)] HTTP/1.1 Host: {your_Odoo_server_url} ``` **JSON Response:** ``` HTTP/1.1 200 OK { 'Partner': [ { 'id': 12, 'name': 'Think Big Systems', 'street': '89 Lingfield Tower', 'street2': false, 'city': 'London', 'state_id': false, 'zip': false, 'country_id': [486, 'United Kingdom'], 'create_date': '2017-07-10 11:02:57', 'create_uid': [1, 'Administrator'], 'write_date': '2017-07-11 15:08:45', 'write_uid': [1, 'Administrator'], ... ... ... }, { 'id': 17, 'name': 'Edward Foster', 'street': '69 rue de Namur', 'street2': false, 'city': 'Wavre', 'state_id': false, 'zip': '1300', 'country_id': [274, 'Belgium'], 'create_date': '2017-07-04 18:10:31', 'create_uid': [1, 'Administrator'], 'write_date': '2017-07-04 19:02:59', 'write_uid': [1, 'Administrator'], ... ... ... }, ... ... ... ] } ``` **XML Response:** ``` HTTP/1.1 200 OK 12 Think Big Systems 89 Lingfield Tower false London false false 486 United Kingdom 2017-07-10 11:02:57 1 Administrator 2017-07-10 15:02:57 1 Administrator 17 Edward Foster 69 rue de Namur false Wavre false 1300 274 Belgium 2017-07-10 11:02:57 1 Administrator 2017-07-10 15:02:57 1 Administrator ``` **Query Parameters:** * **domain** – OPTIONAL. A [search domain](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#reference-orm-domains). Use an empty list to match all records. * **fields** – OPTIONAL. list of field names to return (default is all fields). * **offset** – OPTIONAL. Number of results to ignore (default: none) * **limit** – OPTIONAL. Maximum number of records to return (default: all) * **order** – OPTIONAL. Sort string * **count** – OPTIONAL. if True, only counts and returns the number of matching records (default: False) | Headers and Status Codes | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Request Headers |

Accept – the response content type depends on Accept header
Authorization – The OAuth protocol parameters to authenticate.

| | Response Headers |

Content-Type – this depends on Accept header of the request

| | Status Codes |

200 OK – no error
404 Not Found – there’s no resource
401 Unauthorized – authentication failed
403 Forbidden – if any error raise

| Conversely, picking only three fields deemed interesting. **Request:** ``` GET /restapi/1.0/object/res.partner?domain=[('is_company','=',True),('customer','=',True)]&fields=['name','country_id']&limit=5 HTTP/1.1 Host: {your_Odoo_server_url} ``` **JSON Response:** ``` HTTP/1.1 200 OK { 'Partner': [ { 'id': 7, 'name': 'Agrolait', 'country_id': [274, 'Belgium'] }, { 'id': 12, 'name': 'Think Big Systems', 'country_id': [486, 'United Kingdom'] }, { 'id': 17, 'name': 'Edward Foster', 'country_id': [274, 'Belgium'] }, { 'id': 8, 'name': 'China Export', 'country_id': [302, 'China'] }, { 'id': 10, 'name': 'The Jackson Group', 'country_id': [488, 'United States'] } ] } ``` **Note** even if the `id` the field is not requested, it is always returned --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://synconics.gitbook.io/rest-api/calling-methods/read-records/read-filter-records.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.