Realm Status API documentation?

I was wondering if there was going to be any documentation provided for the realms status api (and others as they are released). What I mean by that is I am interested in the definitions and scope of the data that is going to be provided.

For example if one directs a browser to:

http://us.battle.net/api/wow/realm/status?realm=Bloodhoof

they would get back json data that looks like:

{
"realms":[
{
"type":"pve",
"population":"high",
"queue":false,
"status":true,
"name":"Bloodhoof",
"slug":"bloodhoof"
}
]
}

What are the possibilities for each entry?
i.e
type could be pve, pvp, rp, etc?
population could be full, high, medium, low, empty, etc?
status could be true, false, locked, etc?

Thanks,

Darque
<Elder Tribunal> on Bloodhoof