{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"**This operation allows you to validate a mail batch ID.**\n\nIf you provide a valid batch ID, this operation will return a `200` status code and the batch ID itself.\nIf you provide an invalid batch ID, you will receive a `400` level status code and an error message.\nA batch ID does not need to be assigned to a send to be considered valid. A successful response means only that the batch ID has been created, but it does not indicate that the ID has been assigned to a send.","properties":{"path":{"type":"object","properties":{"batch_id":{"type":"string","description":"Set this parameter to the batch ID that's associated with the mail send you want to retrieve."}},"required":["batch_id"],"additionalProperties":false},"headers":{"type":"object","properties":{"on-behalf-of":{"type":"string","description":"Use the `on-behalf-of` header to make API calls for a particular Subuser through the parent account. You can use this header to automate bulk updates or to administer a Subuser without changing the authentication in your code. You will use the parent account's API key when using this header."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false},"name":"Validate a batch ID.","id":"sendgrid.mail.getmailbatch","example":{"path":{"batch_id":"example"}},"maxRequests":1,"summary":false}}