> For the complete documentation index, see [llms.txt](https://docs.fieldmotion.com/fieldmotion-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fieldmotion.com/fieldmotion-api-docs/invoice/_setstatus.md).

# \_setStatus

Set the Status for an Invoice.

### Parameters

#### id

The ID of the Invoice on which the status will be changed.

#### val

The status to be set for the Invoice.\
Draft => -1\
Quoted => 0\
Invoiced => 1\
Paid => 2\
Cancelled => 3\
Credit Note => 4

### Example

```
FM_api('Invoice_setStatus',[
  'id'=>'697934',
  'val'=>'3'
  ]
);
```

### Result

#### On Success

"id" value in below result will match given "id" parameter value.

```
{"ok":1,"id":697934}
```

#### On Failure

If the "id" parameter is less than 1 or not given a value:

```
{"error":"missing or invalid parameter: id"}
```

If the "id" parameter does not match an existing invoice:

```
{"error":"no such invoice"}
```