# STATUS_READ — Read Object Status

> Reads the system and user statuses of any object that uses SAP status management, such as orders, notifications, equipment or WBS elements. Custom reports use it with the object number (OBJNR) to check statuses like REL, TECO or NOCO. Set ONLY_ACTIVE to get active statuses only.

- Modules: CA
- Type: Function module
- Function group: BSVA
- Remote-enabled (RFC): No
- S/4HANA status: Used the same way in S/4HANA
- URL: https://nekuhub.com/en/functions/status-read/

## Importing parameters

| Parameter | Type | Description | Required |
|---|---|---|---|
| CLIENT | SY-MANDT | Client (exceptional cases only) | - |
| OBJNR | JSTO-OBJNR | Object number of the status object | Yes |
| ONLY_ACTIVE | JEST-INACT | Active statuses only | - |

## Exporting parameters

| Parameter | Type | Description |
|---|---|---|
| OBTYP | JSTO-OBTYP | Object category |
| STSMA | JSTO-STSMA | Status profile |
| STONR | TJ30-STONR | Status number |

## Tables parameters

| Parameter | Type | Description | Required |
|---|---|---|---|
| STATUS | JSTAT | Individual statuses of the object | - |

## Exceptions

- OBJECT_NOT_FOUND: Status object not found

## Call template (ABAP)

```abap
CALL FUNCTION 'STATUS_READ'
  EXPORTING
    objnr = lv_objnr
  IMPORTING
    obtyp = lv_obtyp
    stsma = lv_stsma
    stonr = lv_stonr
  TABLES
    status = lt_status
  EXCEPTIONS
    object_not_found = 1
    OTHERS = 2.
```

## Related tables

JEST, JSTO

