> For the complete documentation index, see [llms.txt](https://synconics.gitbook.io/rest-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synconics.gitbook.io/rest-api/calling-methods/read-records/read-list-records.md).
# Read List Records
Record data is accessible via the [read()](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.models.Model.read_group), which takes a list of ids (as returned by `/restapi/1.0/object/{object_name}`) and optionally domain filter and a list of fields to fetch. By default, it will fetch all the fields the current user can read, which tends to be a huge amount.
**`GET /restapi/1.0/object/{object_name}?ids={comma_separated_ids}`**
**Request:**
```
GET /restapi/1.0/object/res.partner?ids=12,17 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:**
* **fields** – OPTIONAL. list of field names to return (default is all fields).
| 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 | |
| Status Codes | |
Conversely, picking only three fields deemed interesting.
**Request:**
```
GET /restapi/1.0/object/res.partner?ids=12,17&fields=['name','country_id'] HTTP/1.1
Host: {your_Odoo_server_url}
```
**Response:**
```
HTTP/1.1 200 OK
{
'Partner': [
{
'id': 12,
'name': 'Think Big Systems',
'country_id': [486, 'United Kingdom']
},
{
'id': 17,
'name': 'Edward Foster',
'country_id': [274, 'Belgium']
}
]
}
```
**Note**
even if the `id` the field is not requested, it is always returned