# Permit

> One legal instrument governing abstraction from the well (outorga, dispensa, cadastro), from its request on. A mutable record: the attached document is authoritative. The administrative status is stored; the validity status and condition deadlines are derived. A renewal is a new permit whose superse

> **Permit** = `object`

One legal instrument governing abstraction from the well (outorga,
dispensa, cadastro), from its request on. A mutable record: the attached
document is authoritative. The administrative `status` is stored; the
validity status and condition deadlines are derived. A renewal is a new
permit whose `supersedes` points to the previous one. Since v2.3.

## Properties

### attachments?

> `optional` **attachments?**: [`Attachment`](/core/api/type-aliases/Attachment)[]

The legal document.

***

### authority

> **authority**: `string`

Issuing body, e.g. `ANA`, `SEMAS-PA`. Same semantics as `well_id.authority`.

***

### conditions?

> `optional` **conditions?**: [`PermitCondition`](/core/api/type-aliases/PermitCondition)[]

Obligations (condicionantes).

***

### daily\_operating\_time?

> `optional` **daily\_operating\_time?**: `number`

Maximum granted daily operating time in hours. A value above 24 is stored as written; derivations read it as 24.

***

### flow\_rate?

> `optional` **flow\_rate?**: `number`

Maximum granted flow in m³/h.

***

### history?

> `optional` **history?**: [`PermitHistoryEntry`](/core/api/type-aliases/PermitHistoryEntry)[]

Administrative steps (process, notifications, fees).

***

### id

> **id**: `string`

Unique within `permits`. UUID v4 recommended.

***

### identifier?

> `optional` **identifier?**: `string`

Identifier of the granted instrument (portaria, license code), preserved
verbatim. Absent while the permit is only requested.

***

### issued\_at?

> `optional` **issued\_at?**: `string`

Calendar date (YYYY-MM-DD) of issuance.

***

### monthly\_schedule?

> `optional` **monthly\_schedule?**: [`MonthlyGrant`](/core/api/type-aliases/MonthlyGrant)[]

Month-by-month grant.

***

### notes?

> `optional` **notes?**: `string`

***

### renewal\_requested\_at?

> `optional` **renewal\_requested\_at?**: `string`

Calendar date (YYYY-MM-DD) a renewal request was filed.

***

### request\_identifier?

> `optional` **request\_identifier?**: `string`

Identifier of the request or administrative process (protocolo), preserved verbatim.

***

### status?

> `optional` **status?**: [`PermitAdministrativeStatus`](/core/api/type-aliases/PermitAdministrativeStatus)

Administrative situation. Closed vocabulary. Absent means `granted`.

***

### supersedes?

> `optional` **supersedes?**: `string`

`permits[].id` of the instrument this one legally replaces.

***

### type

> **type**: [`OpenVocab`](/core/api/type-aliases/OpenVocab)\<[`PermitType`](/core/api/type-aliases/PermitType)\>

Recommended values: [PERMIT\_TYPES](/core/api/variables/PERMIT_TYPES). Non-canonical values SHOULD use
the `x-` prefix.

***

### updated\_at?

> `optional` **updated\_at?**: `string`

RFC 3339 instant of the last edit of this record.

***

### valid\_from?

> `optional` **valid\_from?**: `string`

Calendar date (YYYY-MM-DD). Absent means valid from `issued_at`.

***

### valid\_until?

> `optional` **valid\_until?**: `string`

Calendar date (YYYY-MM-DD). Absent means no fixed expiry.

***

### volume\_limits?

> `optional` **volume\_limits?**: [`VolumeLimit`](/core/api/type-aliases/VolumeLimit)[]

Volumes stated in the document.

***

### water\_use?

> `optional` **water\_use?**: [`OpenVocab`](/core/api/type-aliases/OpenVocab)\<[`WaterUse`](/core/api/type-aliases/WaterUse)\>[]

What the abstracted water is for. Recommended values: [WATER\_USES](/core/api/variables/WATER_USES).