> 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/formblock/_getbyname.md).

# \_getByName

Gathers the data of a certain Form Block based off its specified name.

### Parameter

#### id

The ID of the Form Block to be deleted.

### Example

```
FM_api('FormBlock_getByName',[
    'name'=>'test_name'
    ]
);
```

### Results

#### On Success

```
{"id":"2","type":"0","name":"test_name","image":null,"code":null,"parent":"0","cdate":"1669565501","last_edited":"1669565501"}
```

#### On Failure

If the "name" parameter is not set or is empty after being trimmed:

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

If the "name" parameter does not match the name of an existing Form Block:

```
{"error":"no such form block"}
```