VB-MAPP Server REST API

The 'X-ClientId' and 'X-ClientCode' header is not required on all requests.  However, when they are required either of the two may be provided to authenticate the call, both are not simultaneously required.

X-ClientCode equates the code field that is provided when the client record is created. This allows you to store a unique value in the code field, for example your primary key, and thus no changes to your data model are required to integrate the REST service.

• Authorization: Token token="<your session token here>"
• User-Agent: dmtd-rest-api
• Content-Type: application/json

curl -X POST \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "Accept: application/json" \
-H "User-Agent: dmtd-rest-api" \
-H "Content-Type: application/json" \
-d '{ "object" : { "code" : "unique code 3", "date_of_birth" : "2014-01-01", "gender" : 1, "organization_id" : 1, "settings" : "anything you want here" } }' \
https://api-sandbox.datamtd.com/1/clients

{
  "response": {
    "id": 439,
    "organization_id": 1,
    "code": "unique code 3",
    "date_of_birth": "2014-01-01",
    "diagnosis": null,
    "first_name": null,
    "gender": 1,
    "last_name": null,
    "created_at": "2015-05-06T14:56:53.729Z",
    "updated_at": "2015-05-06T14:56:53.729Z",
    "settings": "anything you want here",
    "color": null
  }
}

• Authorization: Token token="<your session token here>"
• User-Agent: dmtd-rest-api
• Content-Type: application/json

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "Accept: application/json" \
-H "User-Agent: dmtd-rest-api" \
-H "Content-Type: application/json" \
https://api-sandbox.datamtd.com/1/clients?organization_id=1

{
  "response": [
    {
      "id": 1,
      "organization_id": 1,
      "code": null,
      "date_of_birth": "2015-04-30",
      "diagnosis": null,
      "first_name": null,
      "gender": 1,
      "last_name": null,
      "created_at": "2015-04-30T14:15:19.000Z",
      "updated_at": "2015-04-30T14:15:19.000Z",
      "settings": null,
      "color": null
    },
    {
      "id": 2,
      "organization_id": 1,
      "code": null,
      "date_of_birth": "2015-04-30",
      "diagnosis": null,
      "first_name": null,
      "gender": 2,
      "last_name": null,
      "created_at": "2015-04-30T14:15:19.000Z",
      "updated_at": "2015-04-30T14:15:19.000Z",
      "settings": null,
      "color": null
    },

...

  ],
  "count": 56
}

• Authorization: Token token="<your session token here>"
• User-Agent: dmtd-rest-api
• Content-Type: application/json

• X-DocType: text or html – see Content Formatting for more information
• Accept-Language: <language> – see Content Formatting for more information

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "Accept: application/json" \
-H "User-Agent: dmtd-rest-api" \
-H "Content-Type: application/json" \
https://api-sandbox.datamtd.com/1/guide/index

{
  "response": [
    {
      "sections": [
        
      ],
      "title": "Acknowledgements"
    },
    {
      "sections": [
        {
          "title": "About the VB-MAPP"
        },
        {
          "title": "Research Using the VB-MAPP"
        },
        {
          "title": "The Importance of Assessment"
        },

...

      ],
      "title": "Task Analysis and Skills Tracking: Level 3 (30-48 Months)"
    }
  ],
  "count": 16
}

We reserve the right to alter the results of this index over time as updates to the guide are incorporated. Thus, it is very important that the results of this call are not cached for an indefinite period of time.

To reduce the chatter between servers, it is acceptable to cache this information during a single week period from 6am GMT Monday to 6am GMT Saturday. Any updates to the structures will be done between 6am GMT Saturday and 6am GMT Monday.

• Authorization: Token token="<your session token here>"
• Content-Type: application/json
• User-Agent: dmtd-rest-api
• X-ClientId: <the client id here> or X-ClientCode: <the client code here>

• X-DocType: text or html – see Content Formatting for more information
• Accept-Language: <language> – see Content Formatting for more information

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "Accept: application/json" \
-H "User-Agent: dmtd-rest-api" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
https://api-sandbox.datamtd.com/1/guide/chapter?chapter_num=0

{
  "response": {
    "title": "Acknowledgements",
    "content": "B. F. Skinner's groundbreaking analysis of human behavior (1953) and language (1957) ...  <p>Mark L. Sundberg<p>May, 2014 "
  }
}

• Authorization: Token token="<your session token here>"
• Content-Type: application/json
• User-Agent: dmtd-rest-api
• X-ClientId: <the client id here> or X-ClientCode: <the client code here>

• X-DocType: text or html – see Content Formatting for more information
• Accept-Language: <language> – see Content Formatting for more information

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "Accept: application/json" \
-H "User-Agent: dmtd-rest-api" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
https://api-sandbox.datamtd.com/1/guide/section?chapter_num=1\&section_num=0

{
  "response": {
    "content": "There are five components of the VB-MAPP presented in this Guide. The first is the <B>VB-MAPP Milestones Assessment</B>, ... necessary intervention are included. ",
    "title": "About the VB-MAPP"
  }
}

• Authorization: Token token="<your session token here>"
• User-Agent: dmtd-rest-api
• Content-Type: application/json
• X-ClientId: <the client id here> or X-ClientCode: <the client code here>

Levels are a sub-grouping of the group's questions. The information provided by 'Level Fields' is simply an alternate way to group the questions. This sub-grouping is only used by the 'milestones' areas (i.e. 'Level 1', 'Level 2', 'Level 3').

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "User-Agent: dmtd-rest-api" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
https://api-sandbox.datamtd.com/1/protocol/index

{
  "response": [
    {
      "area": "milestones",
      "groups": [
        {
          "group": "mand",
          "question_count": 15,
          "levels": [
            {
              "level": "level1",
              "start_question_num": 0,
              "question_count": 5,

              "skill_counts": [4, 5, 4, 5, 5]
            },
            {
              "level": "level2",
              "start_question_num": 5,
              "question_count": 5

              "skill_counts": [5, 7, 6, 6, 6]
            },
            {
              "level": "level3",
              "start_question_num": 10,
              "question_count": 5,

              "skill_counts": [5, 5, 6, 4, 5]
            }
          ]
        },
        {
          "group": "tact",
          "question_count": 15,
          "levels": [
            {
              "level": "level1",
              "start_question_num": 0,
              "question_count": 5,

              "skill_counts": [1, 0, 2, 2, 3]
            },
            {
              "level": "level2",
              "start_question_num": 5,
              "question_count": 5,

              "skill_counts": [4, 5, 4, 5, 5]

            },
            {
              "level": "level3",
              "start_question_num": 10,
              "question_count": 5,

              "skill_counts": [9, 7, 6, 5, 7]

            }
          ]
        },

...
  ],
  "count": 4
}

• Authorization: Token token="<your session token here>"
• User-Agent: dmtd-rest-api
• Content-Type: application/json
• X-ClientId: <the client id here> or X-ClientCode: <the client code here>

• X-DocType: text or html – see Content Formatting for more information
• Accept-Language: <language> – see Content Formatting for more information

Example 1 - question_num provided

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "User-Agent: dmtd-rest-api" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
https://api-sandbox.datamtd.com/1/protocol/area_question?area=milestones\&group=mand\&question_num=1

Example 2 - question_num omitted

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "User-Agent: dmtd-rest-api" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
https://api-sandbox.datmtd.com/1/protocol/area_question?area=milestones\&group=mand

Example 1

{
  "response": {
    "example": "A child says or signs \u201cswing\u201d when he is on a swing and wants to be pushed, and he does so without an echoic or imitative prompt.",
    "materials": "Gather items or plan actions that function as reinforcement for the child.",
    "objective": "To determine if a child mands with echoic prompts.  For a child ... necessary.",
    "number": 2,
    "text": "Emits 4 different mands without prompts (except, What do you want?) the desired item can be present (e.g., music, Slinky, ball)  Either testing or observation",
    "title": null,
    "responses": [
      {
        "score": 0,
        "text": "Score 0 Points",
        "description": ""
      },
      {
        "score": 0.5,
        "text": "Score 1\/2 Point",
        "description": ""
      },
      {
        "score": 1,
        "text": "Score 1 Point",
        "description": "Give the child 1 point if he mands for 4 different reinforcers ... (or something similar)."
      }
    ],

    "skills": [

      { "skill": "2-a",

        "text": "Points to 2 different reinforcers in order to obtain them 2 times (E)"

      },

      { "skill: "2-b",

        "text": "Nods or says yes or no when offered a reinforcer 2 times (not an early target) (E)"

	  }, ...

    ]

  }
}

Example 2

{
  "response": [
    {

      "example": "A child says or signs \u201cswing\u201d when he is on a swing and wants to be pushed, and he does so without an echoic or imitative prompt.",
      "materials": "Gather items or plan actions that function as reinforcement for the child.",
      "objective": "To determine if a child mands with echoic prompts.  For a child ... necessary.",
      "number": 2,
      "text": "Emits 4 different mands without prompts (except, What do you want?) the desired item can be present (e.g., music, Slinky, ball)  Either testing or observation",
      "title": null,

      "responses": [
        {
          "score": 0,
          "text": "Score 0 Points",
          "description": ""
        },
        {
          "score": 0.5,
          "text": "Score 1\/2 Point",
          "description": "Give the child \u00bd point if he only emits 1 mand."
        },
        {
          "score": 1,
          "text": "Score 1 Point",
          "description": "Give the child 1 point if ... icon."
        }
      ],

      "skills": [

        { "skill": "2-a",

          "text": "Points to 2 different reinforcers in order to obtain them 2 times (E)"

        },

        { "skill: "2-b",

          "text": "Nods or says yes or no when offered a reinforcer 2 times (not an early target) (E)"

	    }, ...

      ]

  }

    },

{
  "response": [
    {
      "example": null,
      "materials": "Gather items or plan actions that function as reinforcement for the child.",
      "objective": "To determine if a child mands with echoic prompts. For a child using ... be necessary.",
      "number": 1,
      "text": "Emits 2 words, signs, or PECS, but may require echoic, imitative, or other prompts, but no physical prompts (e.g., cracker, book)  Either testing or observation",
      "title": null,
      "responses": [
        {
          "score": 0,
          "text": "Score 0 Points",
          "description": ""
        },
        {
          "score": 0.5,
          "text": "Score 1\/2 Point",
          "description": ""
        },
        {
          "score": 1,
          "text": "Score 1 Point",
          "description": "Give the child 1 point if he responds when an adult provides an ... or icon."
        }
      ]
    },
    {
      "definition": "Emits 4 different mands without prompts (except, What do you want?) the desired item can be present (e.g., music, Slinky, ball). (E)",
      "example": "A child says or signs \u201cswing\u201d when he is on a swing and wants to be pushed, and he does so without an echoic or imitative prompt.",
      "materials": "Gather items or plan actions that function as reinforcement for the child.",
      "objective": "To determine if a child mands with echoic prompts.  For a child using ... necessary.",
      "number": 2,
      "text": "Emits 4 different mands without prompts (except, What do you want?) the desired item can be present (e.g., music, Slinky, ball)  Either testing or observation",
      "title": null,
      "responses": [
        {
          "score": 0,
          "text": "Score 0 Points",
          "description": ""
        },
        {
          "score": 0.5,
          "text": "Score 1\/2 Point",
          "description": ""
        },
        {
          "score": 1,
          "text": "Score 1 Point",
          "description": "Give the child 1 point if he mands for 4 different reinforcers ... similar)."
        }
      ]
    },

  ...

  ],

  "count" : 15
}

• Authorization: Token token="<your session token here>"
• Content-Type: application/json
• User-Agent: dmtd-rest-api
• X-ClientId: <the client id here>

• Accept-Language: <language> – see Content Formatting for more information

The following table lists the various styles that can be used to apply common styling across the generated document.

The grammar for conditions is very trivial. It's simply: "expr op expr".

The Flex lexical description looks as follows:

[ \t\n]                          { /* skip spaces */ }

\%([a-zA-Z_][a-zA-Z0-9_]*)\%     { yylval.string = yytext; return IDENTIFIER; }

[0-9]*                           { yylval.string = yytext; return INTEGER_LITERAL; }

\<=                              { return LT; }

\<=                              { return LTE; }

==                               { return EQ; }

\>=                              { return GT; }

\>=                              { return GTE; }

.                                { yyerror("Unknown token: %s", yytext); yyterminate(); }

A Bison grammar looks as follows:

binary_expr

    : /* empty */

    | value LT value

    | value LTE value

    | value EQ value

    | value GT value

    | value GTE value

;

value

    : IDENTIFIER

    | INTEGER_LITERAL

;

•  Attached to this page is a full Xcode (iOS) application that can be used to verify strings: ReportGrammar.zip
• The list of IDENTIFIER (variable) definitions can be found in IEP - Variable Definitions

curl -X GET \
-H 'Authorization: Token token="9319224d0002e7a32b26c0686c42a0bf"' \
-H "Accept: application/json" \
-H "User-Agent: dmtd-rest-api" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
https://api-sandbox.datamtd.com/1/assessment_report/iep

{
  "response": [
    {
      "Style": "H1",
      "Text": "VB-MAPP Language Milestones, Barriers and EESA Assessment"
    },
    {
      "Style": "Intro",
      "Text": "Name: %STUDENT_FULL_NAME%"
    },
    {
      "Style": "Intro",
      "Text": "Date of Birth: Jan 01, 2014"
    },
    {
      "Style": "Intro",
      "Text": "Age: 1"
    },
    {
      "Style": "Intro",
      "Text": "Assessment Date: %STUDENT_ASSESSMENT_DATES%"
    },
    {
      "Style": "Intro",
      "Text": "Report Date: Dec 13, 2014"
    },
    {
      "Style": "Intro",
      "Text": "Assessor: %STUDENT_ASSESSOR%"
    },
    {
      "Style": "H1NB",
      "Text": "General Information"
    },

...

    {
      "Style": "Normal",
      "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 1",
      "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 1",
      "Text": "Once a child begins to attend to speech sounds, the next task is to get different responses under the control of different sounds. This, of course, is the main activity of standard listener discrimination (LD) training (also identified as receptive labeling). The focus for this child might be to just get him to attend to his own name, or the name of a favorite person, pet, or character (e.g., \"There's Big Bird!\"). A variety of additional activities for developing listener skills can be found in the VB-MAPP Listener Task Analysis."
    },
    {
      "Style": "Normal",
      "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 2",
      "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 2",
      "Text": "The focus for a child who does attend to his own name and perhaps a few other verbal stimuli is to increase the number of listener discriminations that he is able to make. Again, procedures that establish attending to favorite items should be the focus of the intervention at this point. This child may also be ready for more intensive listener training, perhaps beginning with listener discriminations that involve only two stimuli in an array (e.g., responding to, \"Where's Cookie Monster?\" when shown Cookie Monster and a cat)."
    },
    {
      "Style": "Normal",
      "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 3",
      "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 3",
      "Text": "Reaching this milestone means a child has begun to differentially respond to verbal stimuli as demonstrated by identifying specific items during testing. The focus should now be on (1) increasing the number of items the child is able to identify as a listener, (2) begin generalization to different people, settings, and materials, etc., (3) beginning work on emitting specific motor actions on command, and (4) increasing the number of items in a visual array."
    },
    {
      "Style": "Normal",
      "ConditionC_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 4",
      "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 4",
      "Text": "A score at this level suggests that listener training should become a significant part of the child's daily intervention program, along with mands, tacts, and social behavior. The other skills are clearly important, but not as critical as these four skills are for a child whose scores begin to reach the top of Level 1. At this point in the intervention program the focus should be on (1) increasing the number of items the child is able to identify as a listener, (2) increasing the number of items in a visual array\u2014more extensive use of pictures and the use of picture books, (3) an increased effort to generalize to different materials, (4) an increase in training on actions, and (5) more LD training in the natural environment and in the context of social games and social interaction."
    },

...

    {
      "Style": "Normal",
      "Text": "Sundberg, M. L., & Partington, J. W. (1998). Teaching language to children with autism or other developmental disabilities. Concord, CA: AVB Press."
    }
  ],
  "count": 687
}

{
  "response": {
    "example": "A child says or signs \u201cswing\u201d when he is on a swing and wants to be pushed, and he does so without an echoic or imitative prompt.",
    "guideContent": {
      "code": "Mand 1-M",
      "definition": "Emits 4 different mands without prompts (except, What do you want?) the desired item can be present (e.g., music, Slinky, ball). (E)",
      "examples": "A child says or signs \u201cswing\u201d when he is on a swing and wants to be pushed, and he does so without an echoic or imitative prompt.",
      "guidePageNumber": 27,
      "halfPointScoreDefinition": "Give the child \u00bd point if he emits 3 of these types of mands.",
      "level": 1,
      "materials": "Gather items or plan actions that function as reinforcement for the child.",
      "objective": "To determine if a child mands with echoic prompts.  For a child using sign language or a child selecting pictures, can the child mand with imitative or pointing prompts?  If early manding is weak, limited, or typically requires physical prompting, a more careful assessment of the child's exact level will be necessary.",
      "onePointScoreDefinition": "Give the child 1 point if he mands for 4 different reinforcers without the adult saying the target word (echoic prompt), giving an imitative or pointing prompt, or for a child using signs, speaking the word (intraverbal prompt). The desired item or activity can be present, as well as the verbal prompt, \u201cWhat do you want?\u201d (or something similar).",
      "title": "Mand - Level 1"
    },
    "guidePageNumber": 27,
    "materials": "Gather items or plan actions that function as reinforcement for the child.",
    "questionNumber": 2,
    "questionText": "Emits 4 different mands without prompts (except, What do you want?) the desired item can be present (e.g., music, Slinky, ball)\n\n                Either testing or observation",
    "questionType": "E",
    "responses": [
      {
        "score": 0,
        "text": "Score 0 Points"
      },
      {
        "score": 0.5,
        "text": "Score 1\/2 Point"
      },
      {
        "score": 1,
        "text": "Score 1 Point"
      }
    ]
  }
}

{

"milestones" : {

"mand" : [

0,

1,

0.5,

...

]

}

"barriers" : {

"group1" : [

"values" :

]

},

...

}

The following table lists the variables that need to be bound:

bind_milestone_variable

bind_milestone_variable

milestone_score

milestone_gaps, score_gaps

milestone_highest1_point_score

milestone_has_at_least_one

milestone_level_with_first_gap

milestone_knowns

bind_barrier_variable,

barrier_score

bind_barrier_variable

bind_barrier_variable

bind_barrier_variable