Relationships

A relationship defines the kind of association between a student and a parent

List of parent-children relationships

get

This endpoint retrieves all children relationships of parent

Authorizations
Path parameters
parent_idstringRequired

An integer of child's Parent ID

Query parameters
pagestringOptional

An integer defining which page to display.

per_pagestringOptional

An integer defining the number of records to display per page.

Responses
200

Success

application/json
get
GET /v2/parents/{parent_id}/children HTTP/1.1
Host: api.managebac.com
auth-token: YOUR_API_KEY
Accept: */*
200

Success

{
  "children": [
    {
      "id": 1,
      "relationship": "Mother"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Create a parent-child relationship

post

This endpoint creates parent-child relationship

Authorizations
Path parameters
parent_idstringRequired

An integer of child's Parent ID

Body
Responses
201

Created

application/json
post
POST /v2/parents/{parent_id}/children HTTP/1.1
Host: api.managebac.com
auth-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "child": {
    "id": 1,
    "relationship": "Mother"
  }
}
{
  "child": {
    "id": 1,
    "relationship": "Mother"
  }
}

Create and Update Parent-Children Relationships

put

This endpoint completely defines the parent-children relationships.

Authorizations
Path parameters
parent_idstringRequired

An integer of child's Parent ID

Body
Responses
200

Success

application/json
put
PUT /v2/parents/{parent_id}/children HTTP/1.1
Host: api.managebac.com
auth-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "children": [
    {
      "id": 1,
      "relationship": "Mother"
    }
  ]
}
{
  "children": [
    {
      "id": 1,
      "relationship": "Mother"
    },
    {
      "id": 2,
      "relationship": "Brother"
    }
  ]
}

Get a Parent-Child Relationship

get

This endpoint retrieves all information about child relationship to parent

Authorizations
Path parameters
parent_idstringRequired

An integer of child's Parent ID

idstringRequired

An integer of child ID

Responses
200

Success

application/json
get
GET /v2/parents/{parent_id}/children/{id} HTTP/1.1
Host: api.managebac.com
auth-token: YOUR_API_KEY
Accept: */*
{
  "child": {
    "id": 1,
    "relationship": "Mother"
  }
}

Update a Parent-Child Relationship

put

This endpoint updates parent-child relationship

Authorizations
Path parameters
parent_idstringRequired

An integer of child's Parent ID

idstringRequired

An integer of child ID

Body
Responses
200

Success

application/json
put
PUT /v2/parents/{parent_id}/children/{id} HTTP/1.1
Host: api.managebac.com
auth-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "child": {
    "relationship": "Mother"
  }
}
{
  "child": {
    "id": 1,
    "relationship": "Mother"
  }
}

Remove a Parent-Child Relationship

delete

This endpoint removes child relationship to parent

Authorizations
Path parameters
parent_idstringRequired

An integer of child's Parent ID

idstringRequired

An integer of child ID

Responses
204

No content

No content

delete
DELETE /v2/parents/{parent_id}/children/{id} HTTP/1.1
Host: api.managebac.com
auth-token: YOUR_API_KEY
Accept: */*

No content

Was this helpful?