✉️Get a Specific Message

This is the GraphQL query to run when you want to get the body and html of a particular message.

This is the only GraphQL query that will allow you to get the raw body and the html of the message.

Gets a specific message, by id, from a mailbox.

POST https://api.maildrop.cc/graphql

This GraphQL query takes a mailbox and an id as required parameters. Returns a Message object with valid "data" and "html" fields.

Headers

Name	Type	Description
Content-Type	String	application/json

Request Body

Name	Type	Description
	String	'{"query":"query Example { message(mailbox:\"testing\", id:\"AIm59ihdGy\") { id headerfrom subject date } }"}'

200: OK

{
    "data": {
        "message": {
            "id": "AIm59ihdGy",
            "headerfrom": "Test <[e-mail]>",
            "subject": "Testing!",
            "date": "2023-02-09T23:51:14.411Z"
        }
    }
}

See Also

• GraphQL reference type for a Message

Examples

curl

curl --request POST \
    --header 'content-type: application/json' \
    --url https://api.maildrop.cc/graphql \
    --data '{"query":"query Example {\n  message(mailbox:\"testing\", id:\"AIm59ihdGy\") { id headerfrom subject date }\n}"}'

returns:

{"data":{"message":{"id":"AIm59ihdGy","headerfrom":"[e-mail]","subject":"Testing!","date":"2023-02-09T23:51:14.411Z"}}}

React

export const GET_MESSAGE = gql`
    query GetMessage($mailbox: String!, $id: String!) {
        message(mailbox: $mailbox, id: $id) {
            id
            subject
            date
            headerfrom
            data
            html
        }
    }
`;

interface QueryReturn {
    message: Message;
}

interface MyComponentProps {
    mailbox: string;
    id: string;
}

const MyComponent = (props: MyComponentProps) => {
    const { loading, error, data } = useQuery<QueryReturn>(GET_MESSAGE, {
        variables: { mailbox: props.mailbox, id: props.id },
    });
    return (
        <div>
            {loading && <div>Loading...</div>}
            {!loading && error && <div>There was an error.</div>}
            {!loading && data?.message && <div>Message: {data.message.subject}</div>}            
        </div>
    );
};