> For the complete documentation index, see [llms.txt](https://guide.fariaedu.com/integrations-portal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.fariaedu.com/integrations-portal/managebac/public-rest-apis/v2p2/behavior-notes.md).

# Behavior Notes

A Behavior Note is a positive or negative report about an occurance about a student submitted by a teacher.

## Get all behavior notes

> Retrieves all behavior notes recorded for students at the school. Each note includes the incident\
> details, behavior type, next step action, the reporting teacher, and visibility settings for\
> parents and students. Results can be filtered by modification date or specific student IDs.<br>

```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Behavior Notes","description":"A Behavior Note is a positive or negative report about an occurance about a student submitted by a teacher."}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer <token>`."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"BehaviorNote":{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID for note in ManageBac."},"student_id":{"type":"string","description":"School’s own unique ID for student."},"email":{"type":"string"},"first_name":{"type":"string","description":"Student’s first given name."},"last_name":{"type":"string","description":"Student’s surname."},"grade":{"type":"string","description":"Grade name."},"incident_time":{"type":"string","description":"Date/time stamp for incident."},"behavior_type":{"type":"string","description":"Behavior triggering intervention."},"notes":{"type":"string","description":"Reporter’s notes."},"next_step":{"type":"string","description":"Intervention."},"next_step_date":{"type":"string","description":"Date of intervention; yyyy-mm-dd."},"reported_by":{"type":"string","description":"Reporter name."},"homeroom_advisor":{"type":"string","description":"Homeroom Advisor name."}}},"Meta":{"type":"object","description":"Pagination metadata included in all list (index) responses.","properties":{"current_page":{"type":"integer","description":"The page number of the current result set, starting from 1."},"total_pages":{"type":"integer","description":"The total number of pages available for this query."},"total_count":{"type":"integer","description":"The total number of records matching the query across all pages."},"per_page":{"type":"integer","description":"The number of records returned per page — the per_page query parameter, capped at the endpoint's maximum, or the endpoint's default without it. Most endpoints default to 100 and cap at 500; the PBL students endpoints default to 50 and cap at 100."},"next_page":{"type":"integer","description":"The next page number; omitted on the last page."},"prev_page":{"type":"integer","description":"The previous page number; omitted on the first page."},"modified_since":{"type":"string","format":"date-time","nullable":true,"description":"The modified_since filter as parsed; omitted (null on some endpoints) when the request has none."},"deleted_since":{"type":"string","format":"date-time","nullable":true,"description":"The deleted_since filter as parsed, on endpoints that take it; omitted (null on some endpoints) when the request has none."},"q":{"type":"string","description":"The search query, on endpoints that take one; omitted when the request has none."}}},"AccessDeniedError":{"type":"object","description":"Returned when the API token is missing, invalid, or has been disabled.","properties":{"error":{"type":"string","description":"Unauthorized to perform an action"}}}}},"paths":{"/v2p2/behavior/notes":{"get":{"summary":"Get all behavior notes","operationId":"listBehaviorNotes","tags":["Behavior Notes"],"description":"Retrieves all behavior notes recorded for students at the school. Each note includes the incident\ndetails, behavior type, next step action, the reporting teacher, and visibility settings for\nparents and students. Results can be filtered by modification date or specific student IDs.\n","parameters":[{"name":"modified_since","in":"query","description":"A timestamp to filter the modification date of results.","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"An integer defining which page to display.","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","description":"An integer defining the number of records to display per page.","required":false,"schema":{"type":"string"}},{"name":"student_ids","in":"query","required":false,"description":"List of student ids. Accepts repeated params or a comma-separated string.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"integer"}}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"behavior_notes":{"type":"array","items":{"$ref":"#/components/schemas/BehaviorNote"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedError"}}}}}}}}}
```
