# ir.model
Provides information about Odoo models via its various fields
**name**
a human-readable description of the model
**model**
the name of each model in the system
**state**
whether the model was generated in Python code (`base`) or by creating an `ir.model` record (`manual`)
**field\_id**
list of the model’s fields through a [One2many](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.One2many) to [ir.model.fields](/rest-api/inspection-and-introspection/ir.model.fields.md)
**view\_ids**
[One2many](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.One2many) to the [Views](https://www.odoo.com/documentation/16.0/developer/reference/backend/views.html) defined for the model
**access\_ids**
[One2many](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.One2many) relation to the [Access Control](https://www.odoo.com/documentation/16.0/developer/reference/backend/security.html#access-rights) set on the model
**Note**
`ir.model` can be used to:
* query the system for installed models (as a precondition to operations on the model or to explore the system’s content)
* get information about a specific model (generally by listing the fields associated with it)
* create new models dynamically over REST API
**Warning**
* **custom** model names must start with `x_`
* the `state` must be provided and `manual`, otherwise, the model will not be loaded
* it is not possible to add new *methods* to a custom model, only fields
**Example**
Create `x_custom_model` model record in `ir.model` object using [Create Records](/rest-api/calling-methods/create-records.md) API endpoint.
**Request:**
```
POST /restapi/1.0/object/ir.model?vals={'name':'Custom Model','model':'x_custom_model','state':'manual'} HTTP/1.1
Host: {your_Odoo_server_url}
```
**JSON Response**:
```
HTTP/1.1 200 OK
{
'Models': {
'id': 104,
'name': 'Custom Model',
'model': 'x_custom_model',
'state': 'manual'
...
...
...
}
}
```
**XML Response:**
```
HTTP/1.1 200 OK
104
Custom Model
x_custom_model
manual
```
2. Inspect a model `x_custom_model`’s fields using the [Listing Record Fields](/rest-api/calling-methods/listing-record-fields.md) API endpoint.
**Request:**
```
GET /restapi/1.0/object/x_custom_model/fields_get?attributes=['string','help','type'] HTTP/1.1
Host: {your_Odoo_server_url}
```
**JSON Response:**
**Note**
a custom model will initially contain only the “built-in” fields available on all models
```
HTTP/1.1 200 OK
{
'fields': {
'create_uid': {
'type': 'many2one',
'string': 'Created by'
},
'create_date': {
'type": 'datetime',
'string': 'Created on'
},
'__last_update': {
'type': 'datetime',
'string': 'Last Modified on'
},
'write_uid': {
'type': 'many2one',
'string': 'Last Updated by'
},
'write_date': {
'type': 'datetime',
'string': 'Last Updated on'
},
'display_name': {
'type': 'char',
'string': 'Display Name'
},
'id": {
'type': 'integer',
'string': 'Id'
}
}
}
```
**XML Response:**
```
HTTP/1.1 200 OK
many2one
Created by
datetime
Created on
<__last_update type="dict">
datetime
Last Modified on
many2one
Last Updated by
datetime
Last Updated on
char
Display Name
integer
Id
```
---
# 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/inspection-and-introspection/ir.model.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.