Directory Search

The new Directory Search API offers synchronous service calls that can be made by any registered client. By default, only public, unsuppressed directory information will be provided. For access to additional attributes or suppressed information, you must submit a data access request.

The default result format for all calls is JSON, though you can explicitly specify either a JSON or XML format. Note the trailing slashes on all urls.

All requests must be signed and dated.

Search by UIN

Searching by UIN is only available if you have an approved data access request on file that includes access to the UIN.

The following paths can be used to search for an entry by UIN:

https://mqs.tamu.edu/rest/directory/uin/<UIN>/
https://mqs.tamu.edu/rest/directory/uin/<UIN>/json/
https://mqs.tamu.edu/rest/directory/uin/<UIN>/xml/

where <UIN> would be replaced by the person’s UIN.

Search by NetID

The following paths can be used to search for an entry by NetID:

https://mqs.tamu.edu/rest/directory/netid/<NetID>/
https://mqs.tamu.edu/rest/directory/netid/<NetID>/json/
https://mqs.tamu.edu/rest/directory/netid/<NetID>/xml/

where <NetID> would be replaced by the person’s NetID.

Search by searchMailbox

The following paths can be used to search for an entry by searchMailbox:

https://mqs.tamu.edu/rest/directory/smb/<searchMailbox>/
https://mqs.tamu.edu/rest/directory/smb/<searchMailbox>/json/
https://mqs.tamu.edu/rest/directory/smb/<searchMailbox>/xml/

where <searchMailbox> would be replaced by the person’s searchMailbox.

Search by UID

The following paths can be used to search for an entry by UID:

https://mqs.tamu.edu/rest/directory/uid/<UID>/
https://mqs.tamu.edu/rest/directory/uid/<UID>/json/
https://mqs.tamu.edu/rest/directory/uid/<UID>/xml/

where <UID> would be replaced by the person’s UID.