> 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/v2/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 V2","version":"v2"},"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. Defaults to 100; can be overridden with the per_page query parameter (max 200)."}}},"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":{"/v2/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"}}}}}}}}}
```